本文详解如何在 Go Web 应用中，从 MySQL 读取 Markdown 格式的 Body 字段，使用 blackfriday（或现代替代方案 goldmark）转换为 HTML，并通过 template.HTML 安全注入模板，避免双重转义导致的 HTML 显示异常。
本文详解如何在 go web 应用中，从 mysql 读取 markdown 格式的 `body` 字段，使用 `blackfriday`（或现代替代方案 `goldmark`）转换为 html，并通过 `template.html` 安全注入模板，避免双重转义导致的 html 显示异常。
在 Go 的 Web 开发实践中，常需将数据库中存储的 Markdown 文本（如博客正文）动态渲染为 HTML 页面。但若处理不当，极易出现
<strong>Hello</strong>
这类“HTML 被二次转义”的问题——浏览器将其作为纯文本显示，而非解析为加粗段落。根本原因在于：Go 的 html/template 默认对所有 string 类型变量执行 HTML 转义，而你传入的已是合法 HTML 字符串。✅ 正确做法：分离原始内容与渲染结果 + 类型标记
首先，应明确职责分离：Body 保留原始 Markdown 字符串，BodyHtml 存储转换后的 HTML 字符串，并将其声明为 template.HTML 类型——这是 Go 模板系统识别“该内容已可信、无需再转义”的关键标识：
import "html/template"
type post struct {
Id int
Title string
Body string // 原始 Markdown
Tags string
Time string
BodyHtml template.HTML // ← 关键：显式声明为 HTML 类型
}接着，在查询循环中完成转换与赋值（注意：必须在 append 前完成，因结构体是值传递）：
func indexHandler(w http.ResponseWriter, r *http.Request) {
rows, err := db.Query("SELECT id, title, body, tags, time FROM liamka_me_posts LIMIT 2")
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
defer rows.Close()
var posts []post
for rows.Next() {
p := post{}
if err := rows.Scan(&p.Id, &p.Title, &p.Body, &p.Tags, &p.Time); err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
// 使用 goldmark（推荐，blackfriday 已归档）转换 Markdown → HTML
md := goldmark.New()
var buf bytes.Buffer
if err := md.Convert([]byte(p.Body), &buf); err != nil {
p.BodyHtml = template.HTML("<!-- Conversion error -->")
} else {
p.BodyHtml = template.HTML(buf.String()) // ← 强制类型转换，绕过模板自动转义
}
posts = append(posts, p)
}
t.ExecuteTemplate(w, "index.html", posts)
}? 依赖说明：github.com/yuin/goldmark 是当前最活跃、符合 CommonMark 规范的 Markdown 解析器。安装命令：
go get github.com/yuin/goldmark立即学习“前端免费学习笔记（深入）”；
? 常见错误与规避要点
❌ 错误：直接修改 p.Body 并期望模板渲染 HTML
→ Body 是 string，模板会自动转义❌ 错误：未使用 template.HTML 包装转换结果
→ 即使存入 BodyHtml 字段，若类型仍是 string，依然会被转义。❌ 错误：在 append 后再修改结构体字段
→ posts = append(posts, p) 复制的是值，后续对 p 的修改不影响切片中已存元素。⚠️ 注意：确保数据库字段 body 内容为标准 Markdown（无非法 HTML 标签），否则转换可能失败或产生意外输出。
✨ 模板端正确引用方式
在 index.html 模板中，直接使用 {{ .BodyHtml }} 即可原样插入 HTML：
{{ range . }}
<article>
<h2>{{ .Title }}</h2>
<time>{{ .Time }}</time>
{{ .BodyHtml }} <!-- ✅ 安全渲染，不转义 -->
</article>
{{ end }}若需进一步增强安全性（如限制 HTML 标签白名单），可结合 goldmark 的 WithExtensions 配置，或使用 bluemonday 库进行 HTML 清洗。
综上，核心原则有三：字段职责分离、HTML 类型显式标注、转换操作前置至追加前。遵循此模式，即可稳健实现 Markdown 到网页的端到端安全渲染。
