Note
Aa
数字花园写作法:为什么笔记要互链
数字花园不是更漂亮的博客皮肤,而是允许半成品生长、用互链把想法织成可漫游网络的写作法。
技术刊把站点做成「刊 + 花园」,不是为了多一个导航项。它对应一种写作立场:笔记可以半熟,关系要比目录更重要。
如果你刚读完 AI 实用入门,会发现一篇长文里其实埋着多条可独立生长的枝:提示词、安全边界、工作流。互链就是把这些枝显式连起来。
博客时间线 vs 花园网络
| | 传统博客 | 数字花园 | |—|----------|----------| | 默认单位 | 一篇「完成态」文章 | 一个可迭代的笔记节点 | | 组织方式 | 时间倒序 | 链接与主题簇 | | 失败容忍 | 怕写错、怕不完美 | 允许 seedling → evergreen | | 读者路径 | 首页 → 最新 | 任一入口 → 邻接节点 |
时间线擅长「发生了什么」;网络擅长「概念之间怎么连」。技术写作两者都需要:发布可以用时间,理解要靠结构。
先种一棵能活的小树,再谈森林规划。
为什么要互链
互链做三件目录做不到的事:
- 降低重写成本
同一概念不必在每篇文章重讲。链回「定义页」,新文只写增量。 - 暴露知识缺口
当你想写「A 依赖 B」却发现 B 不存在,缺口就可视化了。 - 给陌生人漫游路径
读者不必回到首页猜「下一篇读什么」;文末与花园图提供邻接。
在本站,互链有两条来源:
- Markdown / MDX 正文里的链接
- frontmatter 的
links: [slug, …](构建期并入图谱)
两处都写也可以;图谱会去重。关键是:链的是你真想让人继续读的节点,不是堆 SEO。
最小工作流(我实际在用的)
1. 捕获:先有节点,再谈成文
灵感出现时,先建一个短 Note:
- 标题用判断句或问题句
status: seedling- 3–8 个要点即可
不要等「写得像杂志」再开始。
2. 连边:每篇至少两条有意义的链
发布前自问:
- 它的上游是谁?(概念从哪来)
- 它的下游是谁?(读完可以去哪)
例如本笔记:
- 上游:AI 入门(方法从「会用」延伸到「怎么沉淀」)
- 下游:提示词循环(具体可执行流程)
- 旁支:每日打卡文(产品笔记如何长成公开文章)
3. 生长:状态比完美重要
| status | 含义 | 读者预期 | |--------|------|----------| | seedling | 刚种下 | 可能粗糙,观点未稳 | | growing | 迭代中 | 可读,会改 | | evergreen | 相对稳定 | 可当参考入口 |
把状态写在 frontmatter 里,是对读者的诚实,也是给未来自己的许可:可以改。
4. 修剪:合并、拆分、归档
花园会乱,这是正常的。每隔一段时间:
- 两篇高度重叠 → 合并,旧文改链到新文
- 一篇过长 → 拆出定义页 + 实践页
- 过时结论 → 文首加注或降为 archived 叙事
什么时候不该硬链
- 只为了「图谱好看」而链无关文章
- 链到自己都解释不清的草稿
- 用互链代替论证(「详见某文」却从不讲清关系)
好的链接句子长这样:
提示词循环解决「怎么问」;使用边界 解决「能不能问」。先有循环,再加护栏。
它说明了关系类型,而不只是甩一个 URL。
和 AI 一起写花园
AI 很适合:
- 从长文里抽出可独立成页的子题
- 提议「还缺哪张定义页」
- 把混乱笔记整理成互链候选
它不适合:
- 替你决定哪些想法值得长期维护
- 在未校验时生成一堆假引用节点
本周可执行的三步
- 选你现有笔记里最常复述的一个概念,建成独立短页
- 给两篇已发布文章补上双向(或至少单向)互链
- 打开 花园,看新边是否出现、是否读得通
如果图谱上多了一个你愿意带朋友逛的三角——恭喜,花园开始活了。
收束
数字花园写作法的承诺很克制:允许未完成,要求可连接。
时间线告诉人你最近在写什么;互链告诉人你的思想如何长在一起。技术刊选后者作为底座,不是因为更潮,而是因为——工程师真正需要的,往往是可导航的理解,而不只是又一篇周报。
反向链接
- AI 提示词循环:从一次对话到可复用流程 — 会用 AI 的核心不是神秘咒语,而是可重复的提问循环:目标、上下文、约束、格式、校验。
- AI 实用入门:从概念到会用 — 用一篇长文讲清 AI 是什么、它如何工作、以及普通人怎样把它变成稳定生产力,而不是一次性玩具。
- 每日打卡:给两个人的习惯系统 — 从一个给情侣用的轻量习惯 App 出发,拆开今日打卡、XP 奖励、闯关地图、双人同步与 AI 计划生成是怎么长成一体的。
邻居节点
在花园中查看 →会用 AI 的核心不是神秘咒语,而是可重复的提问循环:目标、上下文、约束、格式、校验。
AI 实用入门:从概念到会用正文链接共同主题用一篇长文讲清 AI 是什么、它如何工作、以及普通人怎样把它变成稳定生产力,而不是一次性玩具。
AI 使用边界:隐私、事实与责任正文链接先划三条线再谈效率:什么不该喂给模型、什么必须核对、最终决策归谁。
每日打卡:给两个人的习惯系统正文链接从一个给情侣用的轻量习惯 App 出发,拆开今日打卡、XP 奖励、闯关地图、双人同步与 AI 计划生成是怎么长成一体的。
BokeBox 播匣:把收藏夹变成听得完的私人播客共同主题推荐开源项目 BokeBox:把视频、链接、文稿与会议材料转成可听完的私人 AI 播客,人设与音色可配,支持 MCP 与自托管。