Markdown + Git：我的技术写作工作流

为什么内容要和站点分离

站点是壳，内容是资产。壳可以换（Astro、Hugo、甚至纯 HTML），资产不能丢。

所以我的做法是：

• 所有内容以 Markdown 存在仓库里，一篇一个文件；
• frontmatter 只放结构化字段：标题、摘要、日期、标签、结论卡、可复现等级、利益披露；
• 站点只负责渲染，不承载内容本身；
• 构建产物是纯静态文件，可以部署到任何地方。

这样即使某天不用 Astro 了，内容也一行不用改。

写作流程

选题池（ideas.md）
  → 写正文（Markdown）
  → 填 frontmatter（结论卡 / 可复现等级 / 利益披露）
  → 本地构建（astro build）
  → 脱敏检查（sanitize-check）
  → 人工复核
  → 发布 + 生成 RSS

构建时校验

两个检查放在 pnpm build 之前：

1. 结构校验：frontmatter 必须通过 schema，缺字段直接构建失败。
2. 脱敏检查：扫描内网 IP、密钥模式、手机号/邮箱、价格、公司名与业务线词表，命中即失败。

把校验放在构建链路里，比“发布前想起来再查一遍”可靠得多。

AI 辅助的边界

AI 适合做：格式整理、标题候选、摘要改写、图表配色、英文翻译初稿。

AI 不适合做：生成测试数据、编造结论、代替人工复核。凡是涉及“数字”和“结论”的部分，必须由我自己跑、自己看、自己签字。

写作节奏

• 每周至少 1 篇，优先写“有数据、有方法”的内容；
• 不追热点，追可复用的结论；
• 每季度回看一次选题池，砍掉两周没人看的方向。

慢一点没关系，稳定比爆发重要。