← 全部文章
knowledge-basewikilinks

Wikilink 双链笔记:让知识库自己连起来

wikilink 双链笔记是用纯 markdown 文件打造知识库最简单、最耐久的方式。你写一条笔记,往另一条笔记丢一个 [[双链]],时间一长这些链接就织成一张可导航的图谱——从一条笔记正向指向它引用的内容,再通过反向链接(backlink)回溯到所有引用它的地方。没有数据库,没有云,只有会自己连起来的 markdown 文件。本文讲清楚反向链接是什么、图谱为什么真的有用,以及 Tybre 如何索引你的 .md 文件来生成它。

什么是 wikilink,什么是反向链接

wikilink 是写成 [[笔记标题]] 的链接,放在 markdown 文件里。它按名字而非文件路径指向另一条笔记,所以你不用记文件在磁盘哪儿。在部署笔记里写 [[Postgres 索引]],你就建了一条正向链接:这条笔记引用了那条。

反向链接是同一条边从另一侧看。打开 Postgres 索引,任何链接到它的笔记都是它的反向链接,包括你的部署笔记。反向那条你从没写过;工具扫描每个文件、算出指向当前笔记的链接。这就是安静的魔法:你边写边正向连,反向链接自己就组装好了。

图谱为什么有用

文件夹树告诉你文件在哪;图谱告诉你想法如何相连。当笔记是节点、wikilink 是边,就会浮现出文件夹结构永远显示不了的聚类:被所有人指向的那条笔记(一个也许该扩写的枢纽)、没有链接的孤儿笔记、只靠一条边相连的两个聚类。

对开发者,这和真实工作严丝合缝:被三份功能规格链接的 decisions/ 笔记、反向链接到它改动过的 runbook 的故障复盘。图谱把这些关系显性化,而不是留在你脑子里。这和 Obsidian(黑曜石)这类工具是同一个思路;工具之间怎么比,见我们的 Tybre 对比 Obsidian

Tybre 如何把笔记索引成图谱

在底层,Tybre 扫描项目里每个 .md.markdown 文件,解析出 [[双链]],建立一个正向索引——从每条笔记到它所链接笔记的映射。它把每个链接目标解析成真实文件,再通过反转这个索引来计算反向链接:对任意一条笔记,凡是正向链接能解析到它的笔记,都是它的反向链接。

索引会被缓存,所以图谱瞬间打开,并且增量更新——你改一个文件,Tybre 只重新索引那个文件,然后在内存里重新解析链接,而不是重扫整个仓库。结果渲染成一张可平移、可点击跳转的交互式图谱。因为这一切都来自磁盘上的文件,你的知识库没有任何东西被困在私有格式里。这种本地优先的特性我们在 本地优先 markdown 笔记 里单独讲了。

实用工作流建议

几个习惯能让 wikilink 图谱真正见效,而不是变成链接意大利面:

  • 提到概念的当下就链接:直接写 [[限流]],别想着以后再补。以后不会来。
  • 用稳定、给人看的笔记标题,而非路径,这样即使你重整文件夹链接仍能解析。
  • 写新笔记前先看反向链接,也许这个想法已经有归处了。
  • 让孤儿笔记先攒着,定期清扫;没链接的笔记是提示,不是失败。
  • 建立枢纽笔记(比如 [[部署]] 索引)连向相关笔记,给图谱天然入口。

常见问题

wikilink 和反向链接有什么区别?

wikilink 是你手写的正向链接,形如 [[笔记]]。反向链接是自动计算的反向边:所有链接到你正在看的这条笔记的笔记。你只写正向,反向链接自己组装。

做笔记图谱需要数据库吗?

不需要。Tybre 通过扫描你的纯 .md 文件里的 [[双链]] 并反转索引来生成图谱与反向链接。一切都留在磁盘上的本地 markdown 里,没有数据库,也没有云账号。

编辑笔记时图谱会更新吗?

会,增量更新。改一个文件只重新索引那个文件并在内存里重新解析链接,图谱和反向链接无需重扫整个项目就保持最新。

这和黑曜石的图谱视图一样吗?

核心思路一样:markdown、wikilink、正向索引、计算出的反向链接。黑曜石的图谱更可配置;Tybre 的则内建在带终端和 Claude Code 的开发者编辑器里。

30 秒安装

立即安装

终端里一行命令——无需邮箱、无需信用卡。

$ curl -fsSL https://tybre.md/install.sh | bash

想用安装包? 下载 DMG