Obsidian 详细教程：构建你的本地知识库
Obsidian 是一款本地优先（local-first）的知识管理与笔记应用。它把每一条笔记保存为普通的 Markdown 文件，存放在你自己的文件夹里，再通过双向链接与知识图谱把这些零散笔记编织成一张属于你自己的"第二大脑"。与依赖云端的 Notion、印象笔记不同，Obsidian 让数据始终掌握在自己手中——即使有天软件消失，那些纯文本笔记依然可读。本教程从核心概念到下载安装、从基础操作到插件进阶，带你完整上手 Obsidian。
1、Obsidian 概述
Obsidian 的设计哲学是"工具不应绑架内容"。它本身只是一个查看与编辑 Markdown 的外壳，真正的资产是那些 .md 文件。你可以在 Obsidian 里编辑，也可以随时用任意文本编辑器打开它们。
- 本地优先：笔记以纯文本 Markdown 存于本地文件夹，离线可用、完全自控
- 双向链接：用 [[笔记名]] 互相关联，自动生成反向链接（Backlinks）
- 知识图谱：可视化全部笔记的链接关系，直观呈现知识网络
- 插件生态：核心插件 + 上千社区插件，几乎可无限扩展
- 跨平台：覆盖 Windows、macOS、Linux、iOS、Android
- 个人使用免费，商用需购买 License
官方网站与资源：
• 官网：https://obsidian.md/
• 下载：https://obsidian.md/download
• 帮助文档：https://help.obsidian.md/
• 开发者文档：https://docs.obsidian.md/
• 官方论坛：https://forum.obsidian.md/
• 官方博客：https://obsidian.md/blog
2、核心概念
2.1、Vault（仓库）
Vault 是 Obsidian 的根目录，一个 Vault 就是一个普通文件夹，里面所有 .md 文件及其子目录构成你的知识库。你可以为工作、生活分别建立独立 Vault，也可以把整个 Vault 放进网盘实现多端同步。
2.2、笔记与 Markdown
每条笔记就是一个 Markdown 文件，支持标准 Markdown 语法，并扩展了高亮、脚注、Callout、数学公式、Mermaid 图表等。文件之间通过链接相互引用，形成网络而非孤立的树。
2.3、双向链接与反向链接
用 [[笔记名]] 即可建立链接；被链接的那篇笔记会自动显示"谁提到了我"，即反向链接（Backlinks）。这是 Obsidian 区别于普通笔记软件的灵魂——笔记不再是孤岛，而是互联的节点。
2.4、标签与属性
用 #标签 给笔记打标，支持 #父级/子级 的层级标签；用 YAML 属性（Properties）给笔记附加结构化字段，如 status、tags、created 等，便于检索与 Dataview 查询。
2.5、知识图谱（Graph View）
Graph View 把所有笔记及其链接关系渲染成一张可缩放的网络图，节点是笔记、连线是链接。随着笔记增多，你能直观看到知识 clusters 的形成与空白区域。
3、下载安装与基础操作
前往官方下载页 https://obsidian.md/download 选对应平台安装包（移动端也可在应用商店搜"Obsidian"）。安装后首次启动，选"Create new vault"新建仓库或"Open folder as vault"打开已有文件夹，建议把 Vault 放进同步目录以便多端共享。核心步骤：
1. 双击安装包，按向导完成安装（全程默认即可）
2. 首次启动新建仓库（Create new vault），命名并选路径，会生成 .obsidian 配置子目录
3. 进入主界面：左侧文件树、中间编辑区、右侧反向链接面板
4. 按 Ctrl/Cmd + N 快速新建笔记，输入标题即文件名
5. 编辑区直接写 Markdown，支持实时预览与源码模式切换（Ctrl/Cmd + E）
建立链接与检索是日常最高频的两个动作：输入 `[[` 会弹出已有笔记列表，选中或新建即可创建双向链接，被链接的笔记自动收到反向链接；查找笔记用快速切换（Ctrl/Cmd + O，按名跳转）和全局搜索（Ctrl/Cmd + Shift + F，全文检索、支持正则）。再记住一个万能键：命令面板 Ctrl/Cmd + P，几乎所有功能都能从这里搜索执行，无需记菜单。
4、Markdown 语法速查
Obsidian 兼容标准 Markdown，并做了一些增强。常用语法如下：
# 一级标题
## 二级标题
**加粗** *斜体* ~~删除线~~ ==高亮==
- 无序列表项
- [ ] 待办任务
- [x] 已完成任务
> 引用块
`行内代码`
[外部链接](https://obsidian.md/)
[[双向链接]]
[[笔记名|显示别名]]
[[笔记名#小标题]] # 链接到某小节
[[笔记名^blockid]] # 链接到块
#标签 #父级/子级
脚注 [^1]
[^1]: 脚注内容属性（YAML frontmatter）写在文件最顶部，用三个短横线包裹：
---
title: 我的笔记
tags:
- 项目
- 学习
status: 进行中
created: 2026-06-27
---5、进阶功能
模板（Templates）：启用核心插件 Templates，预设笔记骨架（标题、属性、时间戳等），新建笔记一键插入，保持结构统一；进阶可用社区插件 Templater 实现动态脚本模板。多窗格与工作区：按住 Ctrl/Cmd 点击链接可在新窗格打开，支持左右、上下分屏；可保存当前窗格布局为工作区（Workspace），适配"调研""写作"等场景一键切换。MOC（Map of Content）：一种"索引笔记"，手动把某一主题下的相关笔记链接汇聚到一篇 MOC 中，充当知识库的"目录页"，弥补纯链接网络的导航缺失。
6、插件生态
Obsidian 自带一批核心插件（在"设置 - 核心插件"开关）：Templates 模板、Daily Notes 日记、Canvas 画布、Backlinks 反向链接、Outline 大纲、Tag Pane 标签面板、Sync / Publish 官方同步与发布等。
在"设置 - 第三方插件"关闭安全模式后即可安装社区插件，最受欢迎的几款：
- Dataview：用类 SQL 查询笔记，生成动态列表与表格
- Templater：功能强大的脚本化模板
- Calendar：侧边栏日历，快速跳转日记
- Kanban：看板视图，管理任务流
- Excalidraw：手绘风格白板与图表
以 Dataview 为例，可在笔记中插入动态查询：
```dataview
TABLE status, created
FROM "项目"
WHERE status = "进行中"
SORT created DESC
```7、同步与发布
官方 Sync：端到端加密的同步订阅服务，配置零门槛、支持版本历史，适合不愿折腾的用户。详见 https://obsidian.md/sync。免费同步方案：由于笔记本质是本地文件，把 Vault 目录放进任意同步盘即可——Apple 生态用 iCloud，跨平台用 OneDrive / Google Drive / 坚果云，极客向用 Git 仓库（配 obsidian-git 插件自动提交）。注意多端同时编辑可能产生冲突文件，建议配合版本管理。官方 Publish：把选定笔记一键发布为带链接图谱的静态网站，适合搭建个人数字花园。详见 https://obsidian.md/publish。
8、最佳实践
- 组织方法：可借鉴 Zettelkasten（卡片盒笔记法）或 PARA 分类法，但不必照搬，先记起来
- 原子化：一条笔记只讲一个观点，便于复用与链接
- 善用链接：宁可多建 [[链接]]，也少建深层文件夹
- 定期回溯：用 Graph View 发现孤岛笔记并补充链接
- 务必备份：本地文件虽稳，仍建议版本管理或多副本
9、总结
Obsidian 用最朴素的 Markdown 文件 + 双向链接 + 知识图谱，重新定义了个人知识管理。它不强求你套用某种笔记法，而是提供一套可无限扩展的工具，让你随用随长，把零散信息沉淀成互联的知识网络。
关键要点：
- 本地优先，笔记即 .md 文件，数据完全自控
- [[]] 双向链接 + Graph View 是知识联网的灵魂
- 命令面板（Ctrl/Cmd + P）是一切操作的中枢
- 插件生态强大，Dataview / Templater 值得优先掌握
- 多端同步可选官方 Sync，也可用网盘 / Git 免费实现
对于任何想系统管理知识、构建"第二大脑"的人而言，Obsidian 都是当前最值得投入的工具之一。它的学习曲线不陡，但上限极高——从记一条日记开始，逐步用链接和插件织出你自己的知识网络，这才是 Obsidian 真正的乐趣所在
