Note

Aa
字号
栏宽

数字花园写作法:为什么笔记要互链

数字花园不是更漂亮的博客皮肤,而是允许半成品生长、用互链把想法织成可漫游网络的写作法。


技术刊把站点做成「刊 + 花园」,不是为了多一个导航项。它对应一种写作立场:笔记可以半熟,关系要比目录更重要。

如果你刚读完 AI 实用入门,会发现一篇长文里其实埋着多条可独立生长的枝:提示词、安全边界、工作流。互链就是把这些枝显式连起来。

博客时间线 vs 花园网络

| | 传统博客 | 数字花园 | |—|----------|----------| | 默认单位 | 一篇「完成态」文章 | 一个可迭代的笔记节点 | | 组织方式 | 时间倒序 | 链接与主题簇 | | 失败容忍 | 怕写错、怕不完美 | 允许 seedling → evergreen | | 读者路径 | 首页 → 最新 | 任一入口 → 邻接节点 |

时间线擅长「发生了什么」;网络擅长「概念之间怎么连」。技术写作两者都需要:发布可以用时间,理解要靠结构。

先种一棵能活的小树,再谈森林规划。

花园原则

为什么要互链

互链做三件目录做不到的事:

  1. 降低重写成本
    同一概念不必在每篇文章重讲。链回「定义页」,新文只写增量。
  2. 暴露知识缺口
    当你想写「A 依赖 B」却发现 B 不存在,缺口就可视化了。
  3. 给陌生人漫游路径
    读者不必回到首页猜「下一篇读什么」;文末与花园图提供邻接。

在本站,互链有两条来源:

  • 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 很适合:

  • 从长文里抽出可独立成页的子题
  • 提议「还缺哪张定义页」
  • 把混乱笔记整理成互链候选

它不适合:

  • 替你决定哪些想法值得长期维护
  • 在未校验时生成一堆假引用节点

具体问法见 提示词循环;喂给模型前记得 使用边界

本周可执行的三步

  1. 选你现有笔记里最常复述的一个概念,建成独立短页
  2. 给两篇已发布文章补上双向(或至少单向)互链
  3. 打开 花园,看新边是否出现、是否读得通

如果图谱上多了一个你愿意带朋友逛的三角——恭喜,花园开始活了。

收束

数字花园写作法的承诺很克制:允许未完成,要求可连接。
时间线告诉人你最近在写什么;互链告诉人你的思想如何长在一起。技术刊选后者作为底座,不是因为更潮,而是因为——工程师真正需要的,往往是可导航的理解,而不只是又一篇周报。

Cheng

Written by

Cheng

Engineer / Writer · Hunan · Remote

关注人工智能、系统设计与知识管理。喜欢把复杂问题写清楚,也把半成品笔记种进花园。