Obsidian 实战：把 LLM Wiki 变成可浏览的第二大脑

Obsidian 实战

Karpathy 的类比很准确：Obsidian 是 IDE，LLM 是程序员，Wiki 是代码库。你不一定必须用 Obsidian，但它确实是 LLM Wiki 最顺手的浏览器。

这篇讲工具层。

目标不是把 Obsidian 配成花园，而是让它服务 LLM Wiki：

人能浏览；
Agent 能维护；
链接能看见；
附件不丢；
页面能被查询。

先说结论

Obsidian 适合做 LLM Wiki 的人类界面，但不要把维护责任交给人。
双链用于概念连接，Graph View 用于看结构，Dataview 用于动态列表。
Web Clipper 很适合收 raw source，但 raw 和 wiki 仍要分层。
图片最好下载到 raw/assets/，不要长期依赖网页 URL。
Obsidian 插件可以慢慢加，先跑通 Markdown + links + graph。

1. 用 Obsidian 打开 Wiki

打开 Obsidian：

选择 Open folder as vault；
选择你的 my-llm-wiki/；
看到 AGENTS.md、index.md、log.md 和目录。

到这里，不需要任何插件。

先确认三件事：

Markdown 页面能打开；
[[wiki/concepts/llm-wiki]] 这类链接能跳转；
左侧文件树能区分 raw 和 wiki。

2. 双链怎么设计

Obsidian 的双链语法：

[[wiki/concepts/llm-wiki]]

建议在 Wiki 里用相对稳定的路径链接，而不是只写：

[[LLM Wiki]]

原因：

Agent 更容易定位文件；
不同目录下重名页面不冲突；
Git diff 更清楚。

2.1 好链接

LLM Wiki 和 [[wiki/concepts/rag-vs-llm-wiki]] 的区别在于知识是否持续积累。

2.2 坏链接

这个东西和 [[那个模式]] 很像。

坏在：

页面名不稳定；
Agent 不知道“那个模式”是什么；
以后容易断。

3. Graph View 怎么用

Graph View 不是拿来欣赏的。

它主要帮你看三个问题：

哪些页面是中心节点；
哪些页面是孤岛；
哪些主题正在形成簇。

3.1 中心节点

比如 llm-wiki.md 被很多页面链接。

这说明它是核心概念。

你应该检查：

这个页面是否写得足够清楚；
是否有来源；
是否需要拆分子概念。

3.2 孤岛页面

如果一个页面孤零零在旁边，通常有三种可能：

情况	动作
忘了加 index	更新 index
缺少相关链接	补双链
页面无价值	标记 archived

3.3 主题簇

如果你看到一组页面聚在一起，比如：

llm-wiki
ingest
query
lint
raw-vs-wiki

说明一个主题已经成形。

这时可以让 Agent 写一篇 synthesis：

请基于 Graph View 中 LLM Wiki 相关页面，整理一篇 wiki/synthesis/llm-wiki-core-workflow.md。
要求引用相关页面，不要直接读 raw。

4. Web Clipper 怎么放 raw

Obsidian Web Clipper 的价值是把网页快速保存成 Markdown。

但保存位置要注意。

建议统一保存到：

raw/articles/

保存后文件名改成：

2026-04-25-karpathy-llm-wiki.md

并补 frontmatter：

  title: "LLM Wiki"
  author: "Andrej Karpathy"
  source_url: "..."
  captured_at: 2026-04-25
  type: article

不要直接保存到 wiki/。

因为 Web Clipper 得到的是原始资料，不是整理后的知识。

5. 图片和附件怎么处理

很多网页剪藏会引用远程图片。

问题是：

远程图片会失效；
Agent 可能无法稳定读取；
以后离线浏览会断；
原文证据不完整。

建议：

raw/assets/

按日期或 source 建子目录：

raw/assets/2026-04-25-karpathy-llm-wiki/

图片链接写成：

![diagram](../assets/2026-04-25-karpathy-llm-wiki/diagram.png)

如果 Agent 需要看图，可以告诉它：

这篇 raw source 包含图片。
请先读文本，再检查 raw/assets/2026-04-25-karpathy-llm-wiki/ 下的图片。
如果图片影响理解，请在 source summary 里说明。

6. Frontmatter 怎么设计

建议所有 wiki 页面都有 YAML：

***
  type: concept
  created: 2026-04-25
  updated: 2026-04-25
  tags: [llm-wiki]
  sources:
  - wiki/sources/karpathy-llm-wiki.md
  status: active
***

字段解释：

字段	作用
`type`	页面类型
`created`	创建日期
`updated`	更新时间
`tags`	主题标签
`sources`	支撑来源
`status`	active / draft / archived

不要一开始加太多字段。

字段越多，Agent 越容易维护不一致。

7. Dataview 怎么用

Dataview 可以根据 frontmatter 生成动态列表。

比如列出所有 question：

TABLE status, updated
FROM "wiki/questions"
SORT updated DESC

列出所有 synthesis：

TABLE updated, tags
FROM "wiki/synthesis"
WHERE status = "active"
SORT updated DESC

列出缺 sources 的概念页：

TABLE updated, tags
FROM "wiki/concepts"
WHERE !sources

这对 lint 很有用。

但注意：

Dataview 是人类浏览增强，不是 LLM Wiki 的核心依赖。

没有它，Wiki 仍然可以运行。

8. Marp 怎么用

Marp 可以把 Markdown 变成幻灯片。

适合把 synthesis 转成分享稿。

比如：

wiki/synthesis/llm-wiki-vs-rag.md

可以让 Agent 生成：

wiki/synthesis/slides-llm-wiki-vs-rag.md

Prompt：

请基于 wiki/synthesis/llm-wiki-vs-rag.md 生成一份 Marp slide deck。
要求：
1. 不新增事实；
2. 每页只讲一个点；
3. 保留最后一页参考来源；
4. 文件写入 wiki/synthesis/slides-llm-wiki-vs-rag.md。

9. Obsidian 使用规则写进 AGENTS.md

可以补一段：

## Obsidian Compatibility

- 使用 Obsidian 双链格式：`[[path/to/page]]`。
- 不使用会破坏 Markdown 可移植性的复杂语法作为核心内容。
- 图片和附件放在 `raw/assets/`。
- wiki 页面使用 YAML frontmatter，便于 Dataview 查询。
- Graph View 中发现孤岛页面时，优先补 index 和相关概念链接。

10. 新手插件顺序

不要一上来装一堆。

建议顺序：

先不用插件，跑通 Markdown；
再用 Web Clipper 收 raw；
再用 Dataview 做动态表；
有展示需求再用 Marp；
需要任务管理时再考虑 Tasks。

插件不是核心。

核心是 raw / wiki / schema / index / log。

练习

用 Obsidian 打开 my-llm-wiki/。
打开 index.md，点击一个 concept 链接。
打开 Graph View，找孤岛页面。
用 Web Clipper 保存一篇文章到 raw/articles/。
让 Agent ingest。
再看 Graph View 是否多出连接。

小结

Obsidian 在 LLM Wiki 里承担的是人类界面：

文件树让你看结构；
双链让你跳转；
Graph View 让你看形状；
Web Clipper 帮你收 raw；
Dataview 帮你查页面状态；
Marp 帮你把 synthesis 变成分享材料。

但记住：

Obsidian 是浏览和审查工具，不是维护者。维护者是 Agent。

下一篇讲 Git：怎么把 Wiki 当代码库维护。

参考资料

Karpathy: LLM Wiki