从零开始搭建 Obsidian 知识库

1、从零开始搭建 Obsidian 知识库

本文面向想从零搭建本地知识库的读者。不预设你用过 Obsidian，也不要求你了解 AI Agent 或语义检索。目标是让你在一天内跑通最小闭环，四周内搭出一个能长期维护的个人知识系统。

2、为什么现在值得从 Obsidian 开始

AI 时代做知识库，问题已经不只是"把资料保存下来"。真正的问题是：这些资料能不能被自己和 AI 长期复用。

普通聊天工具里的回答很快，但它不知道你的经历、项目、判断和表达风格。普通网盘和收藏夹能保存文件，但很难让资料之间形成关系。Obsidian 的价值在这里：它把笔记还原成一个本地 Markdown 文件夹，同时用双向链接、全文搜索、插件和图谱，让这个文件夹逐步长成一个可浏览、可维护、可交给 AI 使用的知识网络。

所以从零搭建 Obsidian，不是为了装一个更复杂的笔记软件，而是为了搭出一个长期可控的个人知识底座。

3、先理解三个核心概念

第一个概念是 Vault。Vault 就是一个普通文件夹，里面放你的 Markdown 笔记、图片、PDF、配置和插件。这个设计很重要：Obsidian 不把你的内容锁在云服务里，哪怕不用 Obsidian，笔记仍然可以用任意文本编辑器打开。

第二个概念是 Markdown 。它是一种纯文本格式，用 # 表示标题，用 - 表示列表，用 [[笔记名]] 表示内部链接。新手不需要一开始背完整语法，只要会标题、列表、加粗、待办和双链，就能开始写。

第三个概念是 双向链接 。当你在一篇笔记里写 [[复利]]，Obsidian 会把它变成可以点击的链接；打开"复利"这篇笔记时，也能看到哪些笔记引用了它。双链让知识之间的关系显性化，笔记越多，价值越明显。

4、第一天只做最小闭环

第一天的目标不是设计完美系统，而是跑通"创建仓库、写笔记、建立链接、能找回来"这个闭环。

安装 Obsidian 后，先创建一个 Vault。建议位置放在容易备份的位置，比如 Documents/ObsidianVault，不要放在系统深层目录。进入设置后，把语言切成中文，把默认编辑模式设为实时预览。

然后创建三篇笔记。

第一篇叫 Home，作为入口页。里面先写三行：

markdown 复制代码

# Home

- [[收集箱]]
- [[项目]]
- [[学习地图]]

第二篇叫 收集箱，专门放临时想法、网页链接、待整理材料。第三篇叫 学习地图，用来放主题入口。你只要能在 Home 里点击跳转、在右侧看到反向链接，就已经理解了 Obsidian 最核心的使用方式。
新手最容易犯的错，是第一天就开始设计十几层文件夹。更稳的做法是先写两周，再根据真实内容长出目录。

5、目录结构：浅文件夹 + 入口笔记

Obsidian 不是不能用文件夹，而是不要把文件夹当唯一组织方式。一个实用的起步结构可以很简单：

plaintext 复制代码

ObsidianVault/
├── 00_Inbox/
├── 10_Projects/
├── 20_Areas/
├── 30_Resources/
├── 90_Archives/
├── assets/
└── Home.md

00_Inbox 放临时输入，10_Projects 放有明确终点的项目，20_Areas 放长期负责的领域，30_Resources 放主题资料，90_Archives 放已结束内容，assets 统一放图片和附件。

这个结构借用了 PARA 的思想，但不要机械执行。它的价值不是分类本身，而是帮你避免"所有文件堆在根目录"和"文件夹深到找不到"两个极端。

真正负责导航的应该是入口笔记，也就是 MOC（Map of Content）。比如 学习地图.md 可以这样写：

markdown 复制代码

# 学习地图

## AI 工程化
- [[Agent 工作流]]
- [[LLM 基础]]
- [[语义检索]]

## 写作
- [[选题池]]
- [[文章素材库]]
- [[发布复盘]]

文件夹解决存放位置，MOC 解决思考路径，双链解决跨主题关联。

6、必须先调好的几个设置

Obsidian 默认可用，但有几项设置建议一开始就调好。

设置项	建议	原因
默认编辑模式	实时预览	新手写 Markdown 摩擦最低
新建笔记位置	指定到 `00_Inbox` 或当前文件夹	避免新笔记散落根目录
附件默认路径	指定到 `assets`	图片、PDF 不会到处乱飞
核心插件	开启日记、大纲、标签、模板、书签	覆盖基础写作和导航
搜索与快速切换	记住 `Ctrl/Cmd + P` 和 `Ctrl/Cmd + O`	一个找命令，一个找笔记

如果你只记两个快捷键，就记 Ctrl/Cmd + P 和 Ctrl/Cmd + O。前者是命令面板，任何功能找不到就搜；后者是快速切换，笔记多了以后比鼠标翻目录快得多。

7、模板和收集箱：降低记录摩擦

知识库能不能长期用下去，关键不在插件多强，而在记录成本够不够低。

建议先建一个 Templates 文件夹，再建三类模板：日记、会议记录、读书笔记。

日记模板可以很短：

markdown 复制代码

# {{date}} 日记

## 今天做了什么

## 今天学到了什么

## 明天最重要的事
- [ ]

会议记录模板只记结论和行动项：

markdown 复制代码

# 会议记录

## 议题

## 结论

## 行动项
- [ ] 负责人 / 事项 / 截止日期

读书笔记模板重点不是摘抄，而是复述：

markdown 复制代码

# 书名

## 一句话总结

## 核心观点

## 对我的启发

## 关联概念
- [[]]

后续可以安装 Templater，把日期、标题、选择项自动填入。但第一阶段不要为了模板自动化耽误写作。模板只服务一个目标：让你更快开始。

8、插件安装节奏：先问题，后插件

Obsidian 的社区插件很强，但插件不是越多越好。新手推荐按三阶段安装。

第一阶段，只装能立刻改善基础体验的插件：

Calendar：配合日记使用，适合每日记录。
Templater：增强模板能力，自动填日期和标题。
Image Toolkit：改善图片预览、缩放和浏览体验。

第二阶段，当你开始用 Obsidian 管事情，再装：

Tasks：汇总散落在不同笔记里的待办。
QuickAdd：用快捷键把灵感快速追加到收集箱。
Periodic Notes：补齐周记、月记和周期复盘。

第三阶段，当笔记数量变多，再考虑：

Dataview：把带属性的笔记查询成表格或列表。
Kanban：用看板管理写作、项目和流程。
Excalidraw：画概念图、流程图和手绘白板。
Various Complements：根据已有笔记标题补全双链。

这里的原则很简单：先遇到问题，再找插件解决。不要因为教程推荐就一次装二三十个插件。插件越多，启动越慢，配置越复杂，排错成本也越高。

9、Obsidian Web Clipper：网页资料采集入口

如果只把 Obsidian 当笔记软件，Web Clipper 可以晚点装；但如果目标是搭一个能给 AI 使用的本地知识库，Obsidian Web Clipper 应该尽早加入。它负责把网页文章、标题、来源、正文和部分元数据转换成 Markdown，保存到 Vault 里。

这一步解决的是输入问题。没有稳定输入，后面的双链、AI 协作都只是空架子。

9.1、安装方式

在浏览器扩展商店搜索 Obsidian Web Clipper，安装后登录或连接本机 Obsidian。安装完成后，打开一篇网页文章，点击浏览器工具栏里的 Web Clipper 图标，选择保存到 Obsidian。

第一次使用时，建议先确认三件事：

Obsidian 已经启动。
当前 Vault 是你要写入的知识库。
Web Clipper 的保存目录指向一个明确的原始资料目录，例如 Clippings/ 或 00_Inbox/web/。

推荐把网页剪藏固定放在一个独立的原始资料目录，而不是直接散落到主题目录。剪藏原文是证据，不是最终知识页。

9.2、推荐保存结构

一个简单可用的结构是：

plaintext 复制代码

ObsidianVault/
├── Clippings/
│   ├── 文章标题.md
│   └── assets/
├── Tech/
├── Personal/
├── ReadingBooks/
└── log.md

Clippings/ 保存原文和附件，Tech/、Personal/、ReadingBooks/ 这类目录保存你读完之后整理出的主题页、方法论和判断。

9.3、剪藏后的标准动作

剪藏一篇文章后，不建议立刻改写原文。更稳的流程是：

plaintext 复制代码

网页文章
  -> Web Clipper 保存为 Markdown
  -> 图片和附件尽量本地化
  -> 保留 source / author / created 等元数据
  -> 读完后在 Wiki 层写自己的总结
  -> 在总结页链接回原始剪藏

如果剪藏内容包含图片，建议在 Obsidian 设置里统一附件存储路径，并给"下载当前文件的附件"绑定快捷键，例如 Ctrl+Shift+D。剪藏后按一次快捷键，把外链图片下载到本地。否则几个月后图片链接失效，原文就会残缺。

9.4、常用场景

Web Clipper 最适合收四类内容：

技术文章：框架解析、工具教程、源码笔记、排错记录。
方法论文章：写作、学习、项目管理、AI Agent 工作流。
资料型网页：官方文档、产品说明、版本发布说明。
长期可复用素材：案例、故事、图表、行业观察。

不建议什么都剪。每次剪藏最好补一句"为什么值得保存"。如果一篇文章没有保存理由，它大概率也不会被再次打开。

9.5、和 AI 的关系

Web Clipper 解决的是 原始资料进入本地 ；后续的整理和编译解决的是 把原始资料变成可复用知识 ；语义检索解决的是 资料变多以后如何快速找到相关内容。

三者顺序不能反过来。没有 Web Clipper 这类输入入口，知识库没有持续材料；只有剪藏、不做整理，知识库会变成另一个收藏夹。

10、同步和备份：知识库越早越要保护

Obsidian 的优点是本地优先，代价是同步和备份要自己认真设计。

如果你想省心，优先考虑 Obsidian Sync。它是官方方案，端到端加密，跨平台体验最好，也内置版本历史。

如果你主要在苹果设备之间使用，iCloud 可以作为轻量方案，但要注意保持文件本地下载，避免系统把文件卸载后导致 Obsidian 读不到。

如果你在国内多平台使用，坚果云 WebDAV 或坚果云官方同步插件是相对容易落地的方案，但大附件和实时同步要谨慎。

如果你有技术基础，Git 是很好的备份和版本历史方案。Obsidian Git 插件可以定时 commit 和 push，但它不是实时同步，也不适合频繁在多台设备同时编辑同一篇笔记。

底线是：无论用哪种同步方式，至少再保留一份独立备份。比如每周把 Vault 复制到移动硬盘，或者用 Git 保留历史。知识库一旦长期使用，它就不是普通文件夹，而是你的长期资产。

11、接入 AI：从聊天助手升级为知识库协作者

Obsidian 可以只作为笔记软件使用，也可以进一步成为 AI 的工作目录。

最简单的方式是在 Obsidian 内安装 Copilot 这类插件，配置 API Key、Base URL 和模型名，让 AI 在侧边栏里帮你总结、翻译、改写和回答当前笔记相关问题。这适合轻量使用。

更进一步的方式，是把整个 Vault 当作本地知识库，让 Claude Code、OpenClaw 这类 AI Agent 直接读取和维护 Markdown。这个时候就需要规则文件，比如 AGENTS.md 或 CLAUDE.md，明确告诉 AI：

markdown 复制代码

1. 原始资料保留，不随意改写。
2. 只有明确说"写入知识库"时才新增或更新知识库。
3. 回答"结合知识库"的问题时，先读索引，再回源核对。
4. 新增重要内容后更新入口、索引和日志。
5. 所有结论尽量保留来源和事实边界。

这一步的重点不是"让 AI 随便改笔记"，而是把 AI 约束成知识库管理员。人负责选择资料、提出问题和判断价值；AI 负责整理、交叉引用、更新索引和维护日志。

12、从笔记软件到个人知识系统

当 Obsidian 只是个人笔记时，核心是写得下去、找得到、能链接。

当它进入更深的阶段，核心就变成三层结构。

第一层是 原始资料。网页剪藏、书摘、会议纪要、聊天记录、论文、截图都属于这一层。这里的原则是保真，不随意改。

第二层是 知识编译层。读完原始资料之后，把稳定结论整理成主题页、实体页、概念页、对比页和方法论页。你平时真正复用的，多数是这一层。

第三层是 规则层。它包括入口索引、维护规则、日志和 Agent 指令。没有这一层，AI 每次维护都可能按不同风格行动，知识库会逐渐漂移。

Karpathy 提出的 LLM Wiki 模式强调一个关键点：不要让 AI 每次查询都从原始文档重新拼答案，而是让它逐步维护一个持久化、相互链接、可更新的 Markdown 知识库。知识只要编译过一次，就应该成为以后可复用的资产。

13、什么时候需要语义检索

小规模知识库不一定需要语义检索。几十篇笔记时，Home、MOC、全文搜索和文件名已经够用。

但当知识库变大，会出现三个问题。

第一，索引变长。AI 每次先读索引，读到几百行以后，定位效率会下降。

第二，关键词不稳定。你想找"独立开发心态变化"，原文可能写的是"做产品越来越无聊"，普通搜索搜不到。

第三，原始细节丢失。编译层保留的是结构和结论，但原文里的例子、数字、原话可能没有进入主题页。

这时可以引入语义检索工具（比如 QMD）。它的定位不是替代 Obsidian，而是作为候选召回层：用关键词匹配处理精确词，用向量搜索处理语义相近内容，再把最相关的片段召回给 AI。

但要注意边界：语义检索返回的是候选，不是事实来源。真正写入分享稿、报告或决策结论时，仍然要打开源 Markdown 回源核对。

14、一个可执行的搭建路线

如果从零开始，可以按四周推进。

第一周，只做基础使用。创建 Vault，写日记、收集箱和 Home。学会 Markdown 基础、双链、搜索和快速切换。

第二周，建立浅目录和模板。把附件路径、默认新建位置、日记模板、会议模板和读书模板调好。开始用 MOC 管主题。

第三周，补齐网页资料入口和按需插件。先安装 Obsidian Web Clipper，把网页文章稳定保存到原始资料目录；再按问题安装 Calendar、Tasks、QuickAdd、Dataview 等插件。

第四周，接入 AI 和备份。先选一个同步/备份方案，再写一份 Agent 规则文件，让 AI 只在明确指令下维护知识库。等笔记规模上来，再考虑更深的知识系统和语义检索。

这个路线的好处是每一步都有产出，不会陷入"配置了很久，但没写几篇笔记"的工具陷阱。

15、结论

从零搭建 Obsidian，最重要的不是插件清单，而是顺序。

先把 Vault 作为本地 Markdown 文件夹跑起来，再用双链和 MOC 建立导航，再用模板和收集箱降低记录摩擦，再用同步和备份保护资产，最后再让 AI 参与维护。

Obsidian 真正值得投入的地方，是它能从一个笔记软件，逐步升级成个人知识系统的前端。前端是 Obsidian，内容是 Markdown，维护者可以是你，也可以是被规则约束好的 AI Agent。

16、参考与边界

Obsidian 基础操作、Web Clipper、插件和同步方案来自 Obsidian 官方文档和社区实践；知识系统三层结构和 LLM Wiki 思路来自 Karpathy 的公开分享。不同系统、设备和插件版本会变化，具体安装界面以当前 Obsidian、浏览器扩展和插件实际版本为准。