Field Note
不要写完 Markdown 就直接发布
写完 Markdown 只是内容完成，不等于发布完成。真正发布前必须检查 frontmatter、slug、tags、build、本地预览、SEO、sitemap 和链接，少一步都可能留下问题。
一句话结论
写完 Markdown 不等于可以发布。从 Markdown 到可公开页面之间，还隔着 frontmatter、slug、tags、构建检查、本地预览、SEO 验证和状态记录。跳过这些步骤，不是快，是埋坑。
这个坑为什么常见
用 AI 写完一篇文章后，很多人会觉得“内容已经好了，直接发就行”。尤其是看到 Markdown 文件保存、内容集合同步成功时，更容易产生一种“已经完成”的错觉。但 Markdown 文件只是一段文本，它要变成一个可访问、可被搜索引擎收录、可以在社交平台正常分享的公开页面，还需要经过一系列验证步骤。
它会造成什么后果
跳过发布前检查的常见后果包括：frontmatter 缺失导致 title / description 在搜索结果中显示异常；slug 错误导致页面链接断裂；tags 混乱导致标签索引页空白或重复；不跑 build 导致上线后才发现构建失败或页面无法访问；不做本地预览导致样式异常、内容截断或嵌套错误；不改 sitemap 导致新页面无法被搜索引擎发现。这些问题在 Markdown 阶段都是不可见的。
更稳的做法
走完整的“本地发布流程”：第一步确认内容类型，第二步检查文件路径和 frontmatter 完整性，第三步确认 tags、slug 和关联链接，第四步本地运行 npm run build，第五步用浏览器打开构建产物逐页检查，第六步记录发布状态到 PROJECT_STATUS。这六个步骤不需要任何复杂工具，也不需要后台管理系统，但它把“写完”和“发布完成”之间的所有缺口都补上了。