Obsidian 小白完整入门:本地知识库从 0 到 1
@ai_xiaomu(黄小木)的 13 章保姆级教程浓缩:安装、界面、Markdown、双向链接、插件、模板、AI 接入、同步备份,一课全拿下。
开篇:AI 时代为什么人人需要知识库
以下来自 @ai_xiaomu。AI 时代,人人都需要一个自己的知识库。为什么?因为 AI 本身没有立场、没有经历、没有审美。直接问它一个问题,回答正确但没有灵魂;让它替你写文章、做方案、整理录音,它给你的永远是通用、平均、谁都能写出来的内容。
差别在哪?在于你能不能把"你自己的素材、方法论、经历、判断"喂给它。同样的模型,喂进去你的东西,输出的就是带你印记的东西。
而本地知识库的最佳方案,就是 Obsidian。一句话:本地的、基于 Markdown 文件的笔记软件,最大特色是双向链接和插件生态。
普通笔记软件像"租来的精装公寓":家具(功能)是房东的,退租就没了。Obsidian 像"自己的毛坯房 + 全套工具箱":房子(Markdown 文件)在你名下,想怎么装修(装插件)都行。
下载安装与第一个仓库
以下来自 @ai_xiaomu。到 obsidian.md/download 下载,按系统点对应按钮:
- Windows:下载 .exe → 双击安装 → 一路下一步 → 桌面出现紫色图标。
- macOS:下载 .dmg → 双击打开 → 把 Obsidian 拖到 Applications 文件夹 → 启动台打开。
- iOS / Android:应用商店搜「Obsidian」安装。建议先在电脑上把基本用法跑通,再装手机版。
启动后让你创建仓库或打开仓库。记住:仓库(Vault)就是一个普通文件夹,你以后写的所有笔记都保存在里面。操作:选「创建新仓库」→ 取名(如"我的笔记")→ 选位置(桌面或文档文件夹,别放 C 盘深处)→ 创建。
把界面改成中文:设置(左下齿轮)→ About → Language 选「简体中文」→ Relaunch 重启。
新手先用一个仓库就够,别一上来建好几个。仓库位置别放 C 盘深处,路径越浅越好找。
界面五区与四个核心概念
以下来自 @ai_xiaomu。界面五大区:最左侧竖条是工具栏(文件、搜索、书签、关系图谱);左侧面板是文件管理区;中间是编辑区(支持多标签页);右侧面板是反向链接、大纲、标签等辅助信息(第一天可以不管);底部状态栏看字数光标(忽略)。
四个核心概念:
- 概念一:仓库(Vault)——一个文件夹,所有笔记存里面。
- 概念二:Markdown——纯文字标记格式,Word 里加标题要点工具栏,Markdown 里只需要在文字前打 # 加空格。语法很少,用着用着自然就会。
- 概念三:双向链接(核心)——在 A 笔记里写 [[B笔记]],两件事发生:① B 变成可点击链接;② 打开 B 时右侧出现反向链接,告诉你 A 引用了它。这就是"双向"——笔记的关联显性化了,笔记越多这张网越值钱。新手记一件事:用 [[词]] 把词括起来就创建了链接,不存在的笔记点一下自动新建。
- 概念四:插件——核心插件官方内置(去设置里开关);社区插件第三方做的(从插件市场装)。第一天不要碰社区插件,先把核心插件用起来。
双向链接像"互相留了电话的两个人":A 记了 B 的号码(正向链接),B 的手机也显示" A 打过电话"(反向链接)。普通超链接是单相思,双向链接是双向奔赴。
写第一篇笔记:Markdown 速查
以下来自 @ai_xiaomu。创建笔记:快捷键 Ctrl/Cmd + N,或左侧文件列表右键 → 新建笔记。标题随便取,先写起来再说,不要纠结。
Markdown 速查(复制即用):
# 一级标题
## 二级标题
### 三级标题
**加粗** *斜体*
- 无序列表项
1. 有序列表项
- [ ] 待办未完成
- [x] 待办已完成
> 引用文字
`行内代码`
[外部链接](https://example.com)
[[内部双链]]
[[内部双链|显示成这段]]
--- (分割线)
三种编辑模式:实时预览(默认推荐,打字时符号自动渲染)、源码模式(看原始符号)、阅读模式(完全渲染、不可编辑)。按 Ctrl/Cmd + E 切换实时预览 / 阅读。
标签与属性:正文写 #读书笔记 这类标签,点击可聚合相关笔记;属性(YAML Frontmatter)写在笔记最顶部、三个减号包裹,记结构化元数据(新手暂不用学)。
---
tags: [读书]
书名: 思考快与慢
作者: 某某某
评分: 5
---
必学的高频功能与必调设置
以下来自 @ai_xiaomu。两个肌肉记忆必须练:Ctrl/Cmd + P 命令面板(万能搜索器,任何功能找不到就在这里搜)、Ctrl/Cmd + O 快速切换(输入笔记名秒开,比鼠标翻文件夹快十倍)。
- 搜索(放大镜):在所有笔记中搜关键词,以后用得最多的功能之一。
- 书签(星标):每天要看的笔记加书签,别去文件列表里翻。
- 关系图谱:可视化所有笔记的连接。笔记少时基本没用,写到几百篇会非常震撼,新手看一眼就行。
必调的几个设置:编辑器 → 默认编辑模式 → 实时预览;文件与链接 → 新建笔记存放位置 → 指定一个收集箱文件夹(否则笔记到处乱跑);附件默认存放路径 → 指定文件夹(如"附件",粘贴/拖入的图片 PDF 统一入库);核心插件确认开启:日记、大纲、书签、标签、模板。
笔记组织的三套方法论
以下来自 @ai_xiaomu。核心原则:文件夹保持浅层(不超过 1-2 级),靠链接和标签做主组织。没写过几篇笔记就开始设计分类,必翻车。
建一篇"目录笔记",里面主要不是正文,而是把同主题的其他笔记按结构列出来。适合做主题入口;还可以建一篇 Home 笔记列出所有 MOC,形成"地图的地图"。
# Python 学习地图
## 基础
- [[变量与数据类型]]
- [[函数]]
## Web 框架
- [[FastAPI 入门]]Projects 项目(正在推进、有终点的事,如"装修房子")、Areas 领域(长期负责、没终点,如"健康""理财")、Resources 资源(兴趣素材库)、Archives 归档(已结束、不活跃)。迁移技巧:从其他工具搬过来时,先把旧笔记全扔进 Archives,桌面干净了,历史还在。
核心三条:每篇笔记只写一个想法、用你自己的话重新表达、主动建立链接。流程"随手记 → 定期整理 → 重写并链接"。适合经常写作、做研究的人。
怎么选:想直观看到主题结构 → MOC;想按"正在做什么"组织 → PARA;想沉淀写作素材 → Zettelkasten。最好的方法是先写半个月,看哪种需求自然冒出来,再有意识地用对应方法。三种可以混着用。
三种方法像三种"整理衣柜"思路:MOC 是"按场合挂好并贴一张全家福索引";PARA 是"按穿的频率分当季/换季/压箱底";Zettelkasten 是"每件衣服只配一套穿搭并记下心得"。
10 个社区插件:分三批装
以下来自 @ai_xiaomu。通用安装方法:设置 → 社区插件 → 「关闭受限模式」→ 「浏览」打开插件市场 → 搜索 → 「安装」→ 点「启用」(很多人忘了点启用,以为插件坏了)。插件市场打不开:切换网络/用加速工具,或去 PKMer 等国内镜像站手动下载,放到 仓库路径/.obsidian/plugins/插件名/ 重启。
安装节奏:第一周 Calendar + Templater + Image Toolkit(看日历、用模板、看图片);第二周 Tasks + QuickAdd + Periodic Notes(任务管理、快速捕捉、周回顾);第三周起 Kanban + Dataview + Excalidraw + Various Complements(功能更强但学习成本更高)。
插件不是装得越多越好!很多人装二三十个,每个浅试一下,结果启动变慢、界面变复杂。正确思路:先遇到问题,再找插件解决。先把笔记写起来,所有插件都是为"写"服务的。
设置 → Templater → Template folder location 填模板文件夹(如"模板");在里面新建"日记模板",内容示例:
# <% tp.date.now("YYYY-MM-DD") %> 日记
> 今天是 <% tp.date.now("dddd") %>。
## 今天发生了什么
## 今天学到了什么
## 明天要做什么
- [ ]新建笔记后 Ctrl/Cmd+P → 搜「Templater: Insert template」→ 选模板,日期自动替换成今天。实操建议:给日记、读书笔记、会议记录、项目笔记各做一个模板。
任务写法:- [ ] 写周报 📅 2026-05-22(📅 截止日期、⏳ 计划日期,不用手敲 emoji:光标放任务行 → Ctrl/Cmd+P → 「Tasks: Create or edit task」弹出可视化编辑器)。汇总视图:在任意笔记写查询块:
not done
due before tomorrow保存后自动列出所有未完成、明天前到期的任务。实操建议:建一篇「任务总览」笔记,放"今天到期 / 本周到期 / 所有未完成"几个查询块。
1. 建一篇「灵感收集箱」笔记;2. 设置 → QuickAdd → 输入"捕捉灵感" → 类型选 Capture → Add Choice;3. 点齿轮配置:File Name 填"灵感收集箱",Capture format 填 - {{VALUE}} ({{DATE:YYYY-MM-DD HH:mm}});4. 点闪电图标 ⚡ 注册为命令;5. 设置 → 快捷键 → 搜「QuickAdd 捕捉灵感」绑快捷键(如 Ctrl/Cmd+Shift+I)。以后:按快捷键 → 输入 → 回车,3 秒搞定。
Obsidian 最强大的插件之一。先给读书笔记加 frontmatter(tags/书名/作者/评分/读完日期),再在任意笔记写:
TABLE 作者, 评分, 读完日期
FROM #读书笔记
SORT 读完日期 DESC保存后自动生成表格,以后每新增一篇读书笔记,表格自动更新。另两个常用查询:
列出最近 7 天创建的笔记:
LIST FROM "" WHERE file.cday >= date(today) - dur(7 days)
列出所有引用了某篇笔记的笔记:
LIST FROM [[某篇笔记]]学习建议:从 TABLE 和 LIST 起步,遇到具体需求再查文档。
其余 6 个一句话:Calendar(右侧可视化月历,配合核心插件「日记」);Image Toolkit(点图片全屏预览,装完即用);Periodic Notes(补齐周/月/季/年记,Format 设 YYYY-[W]ww);Kanban(Trello 风格看板,卡片可写 [[笔记]] 跳转);Excalidraw(手绘白板,图形文字可含双链);Various Complements(打字按 Tab 补全笔记标题,笔记上百后才香)。
场景模板 × 导入资料 × 接入 AI × 同步备份
以下来自 @ai_xiaomu。10 个实操场景模板(别一次全用上,挑 1-2 个先做):每日日记、灵感收集箱、读书笔记(关键:不要抄原文,用自己的话复述)、会议记录(只记结论、决定、行动项)、待办事项、项目计划、知识卡片(能用大白话讲清楚 = 真正理解)、收藏整理(每条写一句"为什么值得看",不写理由的收藏永远不会再打开)、周复盘(后两块"哪里不好 / 下周 3 件事"是重点)、速查手册(WiFi 密码报销流程等,Ctrl/Cmd+O 秒开)。
导入外部资料:Word(装 Importer 插件 → 命令面板「Importer: Import data」);飞书文档(右上 ⋯ → 导出,优先 Markdown);PDF(设好附件文件夹后直接拖进编辑区,![[文件名.pdf]] 可嵌入);音频视频(mp3/wav/m4a、mp4/webm;只放小视频,大视频用网盘存、笔记记链接,否则仓库膨胀同步变慢)。
接入 AI 大模型:装 Copilot 插件(作者 Logan Yang)→ 右侧出现聊天气泡。三个基础概念:API Key(AI 厂商的"钥匙",靠它识别扣费)、Base URL(服务"地址")、Model Name(指定用哪个模型)。推荐 DeepSeek:国内最强之一、价格比 OpenAI 便宜几十倍、注册送免费额度、不需要科学上网。拿 Key:platform.deepseek.com 注册 → API Keys → 创建(sk- 开头字符串只显示一次,立刻复制保存)→ Copilot 里 Add Custom Model 填三项 → Default Model 切 DeepSeek → 聊天框输入"你好,自我介绍一下"验证。
排错 5 清单:① Key 复制完整?前后有空格?② Base URL 结尾 /v1 多加或少加 /?③ Model Name 一字不差?④ 账户还有余额?⑤ 海外模型必须开科学上网。
同步与备份(笔记越攒越值钱,一定要备份):Obsidian Sync(官方付费,端到端加密+版本历史,最省心);坚果云 / iCloud(把仓库放同步目录);Obsidian Git 插件 + 私有 GitHub 仓库(同步 + 完整版本历史可回滚,免费版详见《02 课》);Syncthing(免费开源点对点)。底线:至少保留一份独立本地备份(如每周 rsync 到外置硬盘)。
5 条核心心法:① 先写再整理,别先花两小时设计分类;② 不要追求完美的笔记,一行字也值得记;③ 养成链接习惯,想到关联就顺手 [[]];④ 新手期别装太多插件,先裸用 1-2 周;⑤ 不要把 Obsidian 当收藏夹——原封不动复制粘贴等于零,用自己的话重新表达才有价值。
术语翻卡:点卡片看解释
自测一下:点问题展开参考答案
本地优先(笔记是电脑上的 .md 文件,不依赖云端)、双向链接(A 链 B,B 知道被 A 引用)、插件无限扩展。个人使用完全免费。
在 A 笔记写 [[B笔记]] 后,B 变成可点击链接;打开 B 时右侧会出现反向链接,告诉你 A 引用了它。
都不用先选。先写半个月,看哪种需求自然冒出来再说,三种可以混着用;没写过几篇笔记就开始设计分类必翻车。
因为插件不是越多越好,装多了启动变慢界面变复杂。正确思路是先遇到问题再找插件解决:第一周解决看日历/用模板/看图片,第二周解决任务/捕捉/周回顾,第三周再上 Kanban/Dataview 这类学习成本高的。
API Key、Base URL、Model Name。sk- 开头的 Key 只显示一次,立刻复制保存;复制时检查前后空格;Base URL 结尾 /v1 别多加少加 /;海外模型要开科学上网。