为什么 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。别指望浏览器默认渲染好看——它只保证结构正确。
