写在前面
三叔承认这篇文章的大部分是 AI 生成的,但是:
核心思想是三叔创造的
— 主题选择、观点提炼、应用方向生成的内容是经由三叔审阅的
— AI 生成的文字、案例、细节,三叔逐一审核确认,确保准确、符合意图。AI 只是工具 — 用 AI 辅助写作,就像用 Word 打字、用搜索引擎查资料一样,是工具的使用,不影响内容的原创性和价值。 欢迎你的建议与批评 — 有话直说,三叔不玻璃心
📌 阅读建议:本文约 3000 字,建议收藏后逐节实操。涵盖安装配置 → 同步设置 → 插件生态 → 四大应用场景 → Karpathy 方法论实战。建议先通读一遍,再回头跟着操作。
一、引言:为什么你需要 Obsidian
在 AI 时代,信息的获取成本趋近于零,但知识的沉淀和调用却变得越来越稀缺。你是否有这样的经历:
读过的文章、收藏的帖子,散落在浏览器书签、微信收藏夹、各种笔记软件里,需要时根本找不到。 用 AI 工具(如 Claude Code)写了一个好用的 Prompt,下一次想复用时已经记不清细节。 学了很多课程、看了很多视频,但过一段时间只剩下模糊的印象,无法形成体系。
Obsidian 正是为解决这些问题而生的。它是一款基于本地 Markdown 文件的知识管理工具,具备以下核心优势:
[[笔记名称]] 语法,将所有知识点编织成网状结构 | |
简单来说,Obsidian 不只是一个笔记软件,它是一个以你为中心、永久属于你的知识操作系统。
本文将手把手带你从零开始,用 Obsidian 搭建一套完整的个人知识管理系统。
二、Obsidian 安装与环境配置
2.1 下载客户端
访问 Obsidian 官方网站:
https://obsidian.md/根据自己的操作系统选择对应版本(支持 Windows、macOS、Linux)。
💡 小提示:首次打开时,Obsidian 会让你创建一个"保险库"(Vault)。可以将它理解为一个专属的笔记仓库文件夹。建议在非系统盘(如 D 盘、E 盘)建立专门的文件夹,方便后续用 Git 管理。
2.2 初步配置建议
主题:建议开启"严格模式"(Strict mode),避免误删笔记。 核心插件:开启"每日笔记"(Daily Notes)和"模板"(Templates),这两个是知识管理的基础。 文件与链接:建议将"新建笔记的默认位置"设置为仓库根目录,方便管理。
三、Obsidian + GitHub 同步配置(保姆级教程)
将 Obsidian 与 GitHub 同步,有三个核心好处:
数据备份:本地文件自动同步到云端,防止电脑故障导致数据丢失。 多设备同步:在手机、平板、另一台电脑上也能访问你的知识库。 版本管理:所有笔记的修改历史可追溯,误删也能恢复。
3.1 安装 Git for Windows
下载地址:
https://git-scm.com/install/windows安装时建议全部使用默认选项,一路点"Next"即可。
安装完成后,右键点击任意文件夹 → 选择"Git Bash Here",输入以下命令验证安装成功:
git --version# 输出类似:git version 2.45.0.windows.1 即为成功3.2 安装 GitHub Desktop
下载地址:
https://desktop.github.com/download安装后登录你的 GitHub 账号(没有的话先去 github.com 免费注册一个)。
3.3 创建 GitHub 仓库
打开 GitHub Desktop,点击 **"Create a New Repository on your drive"**。 填写以下信息: Name: obsidian-vault(或你喜欢的名字)Local path:选择你刚才创建的 Obsidian 保险库存放路径 勾选 "Initialize this repository with a README" 点击 **"Create Repository"**。 点击右上角 **"Publish repository"**,将仓库同步到 GitHub 云端(可选择 Private 私有仓库)。
💡 私有 vs 公开:Obsidian 笔记通常包含大量个人思考和隐私内容,建议选择 Private(私有)。
3.4 配置 Git 插件实现自动同步
Obsidian 本身并不原生支持 Git,但我们可以通过安装社区插件来实现。插件安装步骤将在下一节详细说明。
四、常用插件安装与配置
Obsidian 的强大之处在于其插件生态。以下是针对本文应用方向的必备插件:
4.1 进入插件市场
打开 Obsidian → 设置(Settings)→ 社区插件(Community plugins) 点击"Turn on community plugins"(开启社区插件) 在搜索框中搜索插件名称,点击安装
4.2 必备插件清单
| Git | ||
| Templater | ||
| Claudian | ||
| Obsidian Web Clipper | ||
| Media Extended |
4.3 Git 插件配置
安装 Git 插件后,按以下步骤配置:
开启插件:在社区插件列表中找到 Git,点击启用。 设置提交频率: Commit message:建议使用${YYYY-MM-DD}格式,每日自动生成提交记录。Auto save interval:建议设置为5分钟(每 5 分钟自动保存一次更改)。配置 GitHub Desktop 联动:Git 插件负责 git add和git commit,GitHub Desktop 负责git push(推送到云端)。
💡 懒人方案:如果不想折腾命令行,可以完全依赖 GitHub Desktop 的图形界面,手动点击"Sync"按钮进行同步。
五、四大应用方向实战教程
5.1 方向一:MD 文档收集 —— 为 AI 工具建立技能库
核心理念:将你整理好的 Markdown 笔记,归类到 Obsidian 的指定文件夹,作为 AI 工具(如 Claude Code、CodeX、OpenClaw 等)的 Skill 使用。
操作步骤:
在 Obsidian 仓库中创建以下文件夹结构:
obsidian-vault/├── skills/ # AI 技能模板│ ├── writing/ # 写作相关│ ├── coding/ # 编程相关│ └── research/ # 研究相关└── notes/ # 常规笔记在
skills/文件夹中为每个常用任务创建 Markdown 模板,例如skills/coding/quick-review.md:# 快速代码审查 Skill## 任务描述请审查以下代码,重点关注:1. 安全性问题(SQL注入、XSS等)2. 代码可读性与命名规范3. 性能优化空间4. 错误处理是否完善## 输入{{CODE}}将这些文件通过 Git 同步到云端后,即可在 Claude Code 等工具中通过
@引用这些笔记作为上下文参考。
🎯 效果:你的 Obsidian 笔记库 = 你的个人 AI 技能库,每次 AI 交互都基于你整理的最佳实践,而非通用提示词。
5.2 方向二:个人知识库 —— 打造你的第二大脑
核心理念:将阅读、学习、思考的内容全部沉淀到 Obsidian,形成个人知识网络。
推荐工作流:
信息输入 → Obsidian 收集 → 整理归类 → 双向链接 → 知识输出具体操作:
笔记收集:
使用 Obsidian Web Clipper 浏览器插件,一键将网页文章保存到 Obsidian。 安装后,浏览器地址栏右侧会出现一个"回形针"图标,点击即可保存当前页面。 定期整理:
每天或每周安排 15-30 分钟,浏览收集的笔记。 使用 Obsidian 的"反链"(Backlinks)和"局部图谱"(Local Graph)功能,发现笔记之间的关联。 知识输出:
基于整理好的笔记,写博客、做分享、或与 AI 对话时调用。 坚持一段时间后,你会发现自己有了一个"越用越聪明"的知识系统。
5.3 方向三:视频笔记 —— 哔哩哔哩 / 抖音 / YouTube 全平台收录
核心理念:将你看过的优质视频对应的笔记、字幕、思考全部集中管理,不让好内容过眼即忘。
收集哔哩哔哩 / 抖音视频
推荐方案:GET 笔记 + 浏览器自动化 + Obsidian Skill
安装 GET 笔记 浏览器插件(Chrome Web Store 搜索"GET 笔记")。 在 Obsidian 中创建一个专属收集文件夹 inbox/video-notes/。配合浏览器自动化脚本(如油猴脚本 + Claude API),实现: 自动抓取视频标题、UP 主、关键时间戳字幕 生成结构化笔记模板,自动存入 Obsidian
收集 YouTube 视频
推荐插件:Obsidian Web Clipper
安装链接:
https://chromewebstore.google.com/detail/obsidian-web-clipper/cnjifjpddelmedmihgijeibhnjfabmlf安装后:
在 YouTube 视频页面点击插件图标。 选择保存到 Obsidian 的指定文件夹(如 inbox/youtube/)。视频标题、描述、缩略图链接等信息将自动以 Markdown 格式保存。
💡 高阶玩法:配合 Media Extended 插件,可以在 Obsidian 中直接嵌入视频播放器,边看边做笔记。
5.4 方向四:Karpathy 方法论 —— 实现知识复利的核武器
重要参考教程(强烈建议先看视频再读本文):
🔗 保姆级教程 搭建出 Karpathy 同款 AI 知识库!知识复利积累
Karpathy 知识管理方法论的核心思想
Andrej Karpathy(特斯拉 AI 总监、斯坦福教授)曾在多个场合分享过他的知识管理哲学,其核心可以归纳为三点:
一切皆可卡片化:将知识拆解成最小的、可复用的单元——原子笔记(Atomic Note)。每张卡片只讲一件事,但这件事要讲透。
链接优于分类:与其用文件夹层层嵌套,不如让笔记之间通过双向链接自然连接。随着积累增加,你的知识库会自发形成网状结构。
定期回顾与重写:笔记不是写完就结束,而是需要定期重写(Rewriting)。每一次重写都是一次深度思考和知识巩固。
在 Obsidian 中实践 Karpathy 方法论
Step 1:采用 Zettelkasten 笔记法
Zettelkasten(德语"卡片盒")是 Karpathy 方法论的思想源头。在 Obsidian 中实现:
1. 每条笔记只包含一个核心观点2. 笔记标题用问句或关键词(便于搜索)3. 每条笔记末尾添加"相关笔记"的 [[双向链接]]4. 使用 #标签 进行主题聚合Step 2:创建笔记模板
在 Obsidian 的模板文件夹中创建 atomic-note.md:
# {{title}}> 关键词:#{{tag}}## 核心观点(用一句话总结这个知识点)## 详细说明(用自己的话重写,不要复制粘贴原文)## 我的思考(这个知识如何应用到我的工作/生活中?)## 相关笔记- [[相关笔记1]]- [[相关笔记2]]---*创建于:{{date:YYYY-MM-DD}}**标签:#{{tag}}*Step 3:建立定期回顾机制
建议使用 Obsidian 的"日历"(Calendar)插件配合"随机笔记"(Random Note)插件:
每天早上随机抽取 3-5 张旧笔记进行回顾 发现新关联时及时添加双向链接 每周五下午进行一次"周回顾",整理本周新笔记
🎯 终极目标:经过 3-6 个月的积累,你的 Obsidian 知识库将具备"知识复利"效应——每一条新笔记都会自动与旧笔记产生关联,知识网络越织越密,提取价值越来越高。
六、Obsidian CLI —— 让 AI 与笔记直接对话
Obsidian 从 v1.4 版本开始正式支持 CLI(命令行接口),这意味着你可以:
直接用 AI 读取 Obsidian 中的笔记:在 Claude Code 或其他 AI 工具中,通过 @obsidian-vault/笔记标题的方式引用你的笔记作为上下文。AI 自动整理笔记:编写脚本,让 AI 自动为新收集的笔记添加标签、生成摘要、建立链接。 双向同步工作流:AI 生成的内容直接写入 Obsidian,Obsidian 中的思考直接作为 AI 任务的背景资料。
官方文档:
https://obsidian.md/help/cli🚀 未来趋势:随着 AI 和笔记工具的深度融合,Obsidian 不再只是"存放笔记的地方",而是演变为人机协作的共享工作空间。越早建立这套习惯,你的知识复利优势就越明显。
📢 写在最后:知识管理的本质不是"收集",而是"思考"。工具只是放大你思考能力的杠杆——真正重要的,是你愿意花时间把自己的想法写下来、连起来、用起来。希望这篇教程能成为你 Obsidian 之旅的良好起点。
夜雨聆风