JM
← 返回文章
约 2 分钟阅读 更新于 2026年5月20日

Building a Durable Writing System

一种轻量级的方法,让技术笔记在第一周之后仍然有用。


好的写作系统不需要太多活动部件。它们需要清晰的入口、稳定的审查习惯,以及从粗糙笔记到发布作品的低摩擦路径。

Capture

捕获应该足够快,以至于不会成为一项单独的任务。我将简短笔记保持在工作附近:实验日志靠近代码,产品观察靠近截图,文章片段靠近大纲。

重要的区别在于捕获和承诺之间。一个被捕获的想法允许不完整。一个被承诺的笔记有标题、目的和可能的读者。

Shape

每个持久的笔记都会经过三遍打磨:

  1. 这个笔记实际上在解决什么问题?
  2. 在结论有意义之前,读者需要知道什么?
  3. 应该删除什么,因为它只保留了我的思考历史?

最后一个问题是最有杠杆效应的编辑。发布的写作应该保留论证,而不是产生它的每一步。

Publish

当网站的表面区域较窄时,定期发布会更容易。这个博客将文章保存在 MDX 中,项目保存在 Content Collections 中,部署在 GitHub Actions 中。没有数据库,也没有需要维护的运行时服务。

结果是有意为之的无聊基础设施:静态文件、版本化内容和可重复的构建。

Tools I Use

  • Obsidian:用于本地笔记和想法捕获
  • VS Code:用于编辑 MDX 文件
  • GitHub:版本控制和自动部署
  • Astro:静态站点生成

Key Principles

  1. Low Friction:捕获想法应该只需要几秒钟
  2. Versioned:所有内容都应该在 Git 中
  3. Automated:部署应该是自动的
  4. Focused:只保留有价值的内容

This blog is built with Astro and deployed to GitHub Pages.