工作笔记追求及时，公开文章追求准确、完整和可传播。把两者放进同一个目录并自动同步，看起来省事，却容易带来上下文缺失、内容过期和敏感信息外泄。

两种内容承担不同职责

私人笔记可以包含：

  • 尚未验证的假设；
  • 临时命令和原始日志；
  • 与具体代码版本绑定的路径；
  • 只对自己有意义的缩写和上下文。

公开文章则需要：

  • 读者可以独立理解的背景；
  • 明确的证据来源和适用范围；
  • 已清理的示例；
  • 稳定链接和可维护结构。

因此，私人知识库更适合作为选题和证据索引，公开站点则是经过编辑的输出层。

推荐的四步流转

1. 捕获

先快速记录事实、日志位置和当前判断，不为了排版打断调查。

2. 验证

回到代码、规范、构建或实验，确认哪些结论可以复现。把事实、推断和未知项分开。

3. 脱敏与抽象

删除密钥、证书、设备标识、内部地址和未公开产品信息。把只适用于一个项目的细节抽象成可迁移的方法，同时保留适用边界。

4. 发布

把整理后的 Markdown 放入公开站点，经过本地构建、链接检查和人工预览后再推送。

1
原始记录 → 验证笔记 → 脱敏稿件 → 公开文章

为什么不做自动全量同步

自动同步最大的风险不是格式错误，而是语境错误。一条在私人笔记中很清楚的结论，离开对应代码版本和实验条件后，可能被读者理解成普遍事实。

更稳妥的自动化边界是：

  • 自动创建文章草稿；
  • 自动检查链接、格式和构建；
  • 自动生成预览；
  • 保留人工确认发布。

用 Git 保留演进过程

Markdown 与 Git 的组合足够轻量：

  • diff 能看出结论如何变化；
  • commit 能把文章与验证节点关联；
  • 回滚不会依赖特定编辑器；
  • GitHub Pages 可以自动构建发布。

工具的价值不在于把所有内容塞到一起，而在于让每一种内容都拥有清晰的生命周期和公开边界。