Golang初级实战：开发一个简单的Markdown预览器 Go语言Web后台实战

为什么 net/http 直接 ServeFile 无法正确渲染 markdown？

因为 ServeFile 只做静态文件透传，不解析 .md 内容，浏览器收到的是纯文本（Content-Type: text/plain），不是 HTML。你看到的是一堆带 # 和 * 的原始文本，而不是标题和列表。

真正要做的，是「读取 → 解析 → 渲染 → 返回 HTML」这个链路。关键不在 HTTP 服务本身，而在中间缺了 Markdown 解析器。

• 别用 http.ServeFile 或 http.FileServer 直接暴露 .md 文件
• 推荐用轻量解析库，比如 github.com/gomarkdown/markdown（比 blackfriday 更活跃、API 更直白）
• 注意默认不启用 HTML 渲染——必须显式加 markdown.HTML 选项，否则输出仍是带转义的 HTML 字符串
• 示例片段：

  md := markdown.ToHTML([]byte("# Hello"), nil, &markdown.Options{Extensions: markdown.CommonExtensions})

如何让 Go Web 服务实时响应 Markdown 文件变化？

开发阶段手动重启太慢，但 fsnotify 这类监听方案容易过度设计。更务实的做法是：用内存缓存 + 简单时间戳校验，不依赖外部工具。

• 每次请求时，先用 os.Stat 检查文件 ModTime() 是否变化；没变就直接返回缓存的 HTML
• 缓存用 sync.map 即可，key 是文件绝对路径，value 是 Struct{ html []byte; modtime time.Time }
• 不要监听整个目录——fsnotify 在 docker 或某些 ide 下常失效，且热重载逻辑混进 HTTP handler 会让调试变复杂
• 如果真需要自动刷新页面，前端加个 EventSource 轮询 /api/reload 接口比 websocket 更轻量

为什么本地打开 HTML 预览正常，但 Go 服务返回的页面样式错乱？

大概率是 CSS 路径或 Content-Type 搞错了。Go 默认不设 Content-Type，浏览器会按 text/plain 或 text/html; charset=utf-8（无 <meta> 时）猜测，导致样式表 404 或编码异常。

立即学习“go语言免费学习笔记（深入）”；

• 务必在写响应前调用 w.Header().Set("Content-Type", "text/html; charset=utf-8")
• CSS 如果内联，用 <style></style> 标签包住；如果外链，路径必须相对于你的 http.ServeMux 注册路径，比如注册了 http.Handle("/Static/", http.StripPrefix("/static/", http.FileServer(http.Dir("./static"))))，那 HTML 里就得写 <link href="/static/main.css">
• 避免用相对路径如 ./css/main.css——浏览器按当前 URL 解析，不是按 Go 代码位置
• 检查浏览器开发者工具 Network 面板，看 CSS 请求是否返回 404 或 MIME 类型错误（比如返回了 text/plain）

要不要用 embed 打包前端资源？

要，但只在准备发布二进制时做。开发期硬 embed 会导致改一行 CSS 就得重新编译，破坏快速反馈循环。

• 开发时用 http.FileServer 服务 ./static 目录，和 Markdown 文件分离管理
• 上线前才用 //go:embed static/* + embed.FS，配合 http.FileServer(http.FS(staticFS))
• 注意 embed 不支持 glob 递归，子目录要显式写成 static/**/*（Go 1.16+）
• 如果用了 embed 却忘了删掉本地 ./static 目录，运行时不会报错，但可能加载到旧文件——因为 http.FileServer 优先读磁盘而非 embed

最易被忽略的点：Markdown 解析后的 HTML 默认不包含任何样式，表格、代码块、引用这些元素全靠你自己补 CSS。别指望浏览器默认渲染好看——它只保证结构正确。