📖 本文导读:
这篇Obsidian使用教程将带你从零开始,全面掌握Obsidian.md这款本地优先、Markdown驱动的双链笔记工具。无论你是刚刚听说Obsidian的新手,还是希望系统梳理Vault管理方法的老用户,本文都将为你提供清晰的操作路径。教程涵盖:官方下载安装全流程、Vault创建与配置、Bi-directional Links(双向链接)核心操作、Graph View(知识图谱)可视化解读、Command Palette(命令面板)与Hotkeys(快捷键)效率技巧、8大核心插件详解、笔记组织方法论,以及Quick Switcher等高频功能实操。通过本文,你将建立起完整的 Obsidian 知识管理认知框架。
1. Obsidian下载安装 Download & Install
开始你的Obsidian之旅的第一步,就是从官方网站下载并安装客户端。Obsidian.md支持所有主流操作系统,并且完全免费。
1.1 官网下载
访问 Obsidian 官网 obsidian.md,点击首页的"Download"按钮即可进入下载页面。官网会自动检测你的操作系统并提供对应的安装包。你也可以手动选择以下版本:
- Windows:支持 Windows 10/11,提供 exe 安装包和便携版(Portable)两种选择。便携版无需安装,解压即可运行,适合在U盘等移动设备中使用。
- macOS:支持 Intel 和 Apple Silicon(M1/M2/M3/M4)芯片,提供 dmg 安装包,也支持通过 Homebrew 安装(命令:brew install --cask obsidian)。
- Linux:提供 AppImage、Snap、Flatpak 三种格式,兼容 Ubuntu、Fedora、Debian、Arch 等主流发行版。
- iOS/iPadOS:在 App Store 搜索"Obsidian"即可免费下载,支持 iPhone 和 iPad。
- Android:在 Google Play 商店搜索"Obsidian"下载,也可在官网直接下载 APK 安装包。
1.2 安装注意事项
安装过程非常简单,但有几个关键点需要注意:
- 语言选择:Obsidian 安装后默认为英文界面,你可以在设置中的"About"选项卡底部切换为简体中文。
- 账户体系:Obsidian 不需要注册账户即可使用核心功能。如果后续需要使用官方同步(Sync)或发布(Publish)服务,再注册一个 Obsidian.md 账户即可。
- 离线可用:安装完成后完全离线可使用,无需联网。这与其他云端笔记工具截然不同。
💡 独特观点①
Obsidian 的便携版(Portable)策略值得所有知识工作者重视。 大多数笔记工具强制要求安装和登录,而 Obsidian 的便携版让你可以在U盘或移动硬盘中预装整个 Vault,在任意 Windows 电脑上即插即用。这种"数据随身"的能力在知识管理工具中极为罕见,尤其适合需要频繁切换设备的自由职业者和咨询顾问。
2. 创建第一个Vault Your First Vault
Vault(知识库仓库)是 Obsidian 中最核心的概念。简单来说,Vault 就是一个文件夹,里面存放着你所有的 Markdown 笔记文件、附件、配置等数据。理解 Vault 的运作方式是高效使用 Obsidian 的基础。
2.1 创建Vault的两种方式
首次启动 Obsidian 时,你会看到"Create new vault"(创建新知识库)和"Open folder as vault"(打开文件夹作为知识库)两个选项。
- 创建新知识库:选择此选项后,指定一个本地路径名称(如"MyBrain"),Obsidian 会自动在该路径下生成必要的文件夹结构(.obsidian 配置目录)。建议选择一个有足够磁盘空间且方便备份的位置。
- 打开已有文件夹:如果你已经有一个 Markdown 笔记文件夹(例如之前用 Typora 或 VS Code 写的笔记),直接选择此选项即可将其作为 Vault 导入。Obsidian 会自动识别所有 .md 文件。
2.2 Vault目录结构解析
创建 Vault 后,建议在文件管理器中观察其目录结构。一个典型的 Vault 包含:
MyBrain/ <-- Vault根目录
├── .obsidian/ <-- Obsidian配置文件夹(隐藏)
│ ├── plugins/ <-- 社区插件存放目录
│ ├── themes/ <-- 主题文件目录
│ ├── snippets/ <-- CSS代码片段
│ ├── workspace <-- 工作区布局文件
│ └── community-plugins.json <-- 已安装插件清单
├── 笔记1.md
├── 笔记2.md
├── attachments/ <-- 附件文件夹(按需创建)
└── templates/ <-- 模板文件夹(按需创建)
2.3 多Vault管理策略
你可以创建多个 Vault 来隔离不同领域的知识。例如:
- 工作Vault:存放项目文档、会议记录、周报等与工作相关的内容
- 学习Vault:存放课程笔记、读书笔记、论文摘录
- 个人Vault:存放日记、随想、生活记录、兴趣爱好
在 Obsidian 中,通过"Settings → About → Switch vault"可以快速切换不同 Vault。你也可以使用 Quick Switcher(快捷键 Ctrl+O)在当前 Vault 中快速查找和切换笔记。
3. 界面介绍 Interface Overview
Obsidian 的界面设计干净而灵活,采用"窗格(Pane)"架构,所有元素都可拖拽、缩放、拆分。熟悉界面布局是高效操作的第一步。
3.1 左侧边栏
左侧边栏是 Vault 的主要导航区域,包含以下核心面板:
- 文件列表(File Explorer):以树状结构显示 Vault 中所有文件和文件夹,支持拖拽移动、右键菜单操作。
- 搜索(Search):全局全文搜索,支持正则表达式、文件名过滤、路径限定等高级搜索语法。
- 书签(Bookmarks):收藏常用笔记、搜索结果或查询语句,支持分组管理。
- 反向链接(Backlinks):显示当前笔记被哪些其他笔记引用,是知识发现的核心入口。
- 大纲(Outline):自动提取当前笔记的标题结构,方便快速跳转。
- 标签面板(Tags):聚合显示 Vault 中所有使用的标签及出现次数。
3.2 编辑器与预览
Obsidian 提供三种编辑模式:
- 编辑模式(Edit):所见即所得的 Markdown 编辑体验,支持实时渲染链接、加粗、列表等基础语法。
- 预览模式(Reading):完全渲染后的阅读视图,适合最终内容的审阅。
- 分屏模式(Split):同时在左右或上下两个窗格中打开编辑和预览,适合对照编写。
按 Ctrl+E(macOS 为 Cmd+E)可以在编辑和预览之间快速切换。
3.3 命令面板(Command Palette)
Command Palette(命令面板)是 Obsidian 中最重要的效率工具。按 Ctrl+P(macOS: Cmd+P)即可打开,输入关键词即可搜索和执行所有可用的操作——从创建笔记、插入模板到运行插件命令,几乎一切操作都可以通过命令面板完成。这是新手从"鼠标点击"进阶到"键盘驱动"的关键一步。
💡 独特观点②
Obsidian 的"窗格化"界面设计本质上是一种"认知工作台"思维。 与传统笔记工具固定的布局不同,Obsidian 让你像搭积木一样自由组合文件列表、Graph View、大纲、反向链接等面板。这种灵活性的深层意义在于——每个人的思维模型不同,所需的视觉布局也不同。将界面布局与个人认知模式对齐,是提升知识管理效率的隐形杠杆。
4. Markdown基础语法 Markdown Basics
Markdown 是 Obsidian 的底层语言。所有笔记都以纯文本 Markdown 格式存储,这意味着即使离开 Obsidian,你的笔记仍然是完全可读、可迁移的。以下是 Obsidian 中最常用的 Markdown 语法:
4.1 标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
建议笔记只使用到三级标题(###),层级过深反而不利于信息检索。
4.2 列表
- 无序列表项1
- 无序列表项2
- 嵌套列表(缩进2或4个空格)
1. 有序列表项1
2. 有序列表项2
3. 有序列表项3
4.3 链接与图片
[链接文字](https://example.com)

4.4 代码块
```python
def hello():
print("Hello, Obsidian!")
```
4.5 表格
| 标题1 | 标题2 | 标题3 |
|-------|-------|-------|
| 内容A | 内容B | 内容C |
4.6 其他常用语法
- 加粗:**文字** → 文字
- 斜体:*文字* → 文字
- 删除线:~~文字~~ → ~~文字~~
- 高亮:==文字== → 文字高亮(Obsidian 扩展语法)
- 引用:> 引用文字 → 引用区块
- 分割线:--- 或 ***
- LaTeX公式:$E=mc^2$(行内)或 $$E=mc^2$$(块级)
Markdown 的好处是语法极简、学习成本低。你只需要记住 10% 的语法就能完成 90% 的写作需求,剩下的可以随时查阅。这也正是 Obsidian 选择 Markdown 作为底层格式的原因——知识的价值在于内容本身,而非排版样式。
5. 双向链接核心操作 Bi-directional Links
Bi-directional Links(双向链接)是 Obsidian 区别于传统笔记工具的灵魂功能。它让笔记从"文件夹中的独立文件"进化为"知识网络中的互联节点"。
5.1 创建双向链接
在 Obsidian 中,创建一个链接只需要在编辑器中输入 [[,系统会自动弹出搜索框,输入目标笔记名称即可:
[[Zettelkasten]] <-- 链接到名为"Zettelkasten"的笔记
[[PARA方法|我的工作流]] <-- 链接并自定义显示文字
[[2026-01-15#总结]] <-- 链接到特定笔记的特定标题
5.2 反向链接面板
这是 Bi-directional Links 中"双向"二字的体现。当你在笔记 A 中输入 [[笔记B]] 后,打开笔记 B,在右侧边栏的"反向链接(Backlinks)"面板中会自动显示"笔记A 引用了我"。这意味着:
- 你不需要手动维护"谁链接到了我"——Obsidian 自动完成
- 反向链接面板会展示链接所在的上下文片段,方便快速了解关联内容
- 你可以直接在反向链接面板中创建新的反向链接,形成双向闭环
5.3 未被创建的链接(Unlinked Mention)
反向链接面板还包含一个"未链接提及(Unlinked mentions)"区域,它会自动检测当前笔记中提到了其他笔记的标题但尚未创建显式链接的文本,并提示你一键添加链接。这是知识发现和链接补全的利器。
5.4 链接图谱与知识发现
随着你创建越来越多的 Bi-directional Links,你的 Vault 会逐渐从"一叠独立的笔记"进化成"一张互联的知识网络"。这种网络结构的价值在于:当你在阅读一篇笔记时,侧边栏的反向链接会告诉你"还有哪些笔记与这个话题相关",这种隐形的知识推荐机制可以极大地促进跨领域思考和创新洞察。
6. 知识图谱使用 Graph View
Graph View(知识图谱)是 Obsidian 最具视觉冲击力的功能之一。它将 Vault 中所有的 Bi-directional Links 关系以节点-连线图的形式可视化呈现。
6.1 打开Graph View
在左侧边栏点击"Open graph view"图标(或使用命令面板搜索"Graph View"),即可打开全局图谱。你会看到一个个圆形节点代表笔记,节点之间的连线代表链接关系。
6.2 局部图谱 vs 全局图谱
- 全局图谱(Global Graph):展示 Vault 中所有笔记及其链接关系。适合从宏观角度审视知识库的整体结构和领域分布。
- 局部图谱(Local Graph):在笔记编辑界面右上角点击"更多选项 → Open local graph"打开。仅展示当前笔记及其上下两级关联笔记,适合深度聚焦一个具体主题。
6.3 图谱过滤与布局
Graph View 提供丰富的过滤和布局选项:
- 按标签过滤:只显示包含特定标签的笔记节点,适合聚焦某一领域。
- 按路径过滤:只显示特定文件夹下的笔记,适合项目级视角。
- 搜索过滤:输入关键词,只显示名称匹配的节点及其关联。
- 布局切换:支持力导向布局(Force-directed)、径向布局(Radial)等,不同布局适合不同分析目的。
- 节点大小:链接数量越多的节点显示越大,帮助你快速识别 Vault 中的"中心节点"(即被引用最多的笔记)。
6.4 图谱的实用场景
- 发现知识孤岛:没有任何连线的孤立节点表示该笔记与知识库缺乏关联,提示你建立链接。
- 识别核心主题:被链接最多的节点就是你在该领域最核心的知识沉淀。
- 寻找跨领域连接:两个不同领域的集群之间的连线,往往意味着跨学科创新的机会。
7. 快捷键与命令面板 Hotkeys & Command Palette
掌握Hotkeys(快捷键)和Command Palette(命令面板)是提升 Obsidian 操作效率的关键。当你从"鼠标点击"转变为"键盘驱动"后,笔记创作速度会有质的飞跃。
7.1 命令面板(Command Palette)
按 Ctrl+P(macOS: Cmd+P)打开命令面板后,直接输入关键词即可执行任意操作。常用命令示例:
- "new note" → 创建新笔记
- "toggle edit" → 切换编辑/预览模式
- "graph view" → 打开知识图谱
- "insert template" → 插入模板
- "backlinks" → 打开反向链接面板
7.2 高频快捷键一览
| 快捷键 | 功能 | 说明 |
| Ctrl+P | 命令面板 | Obsidian 的终极入口 |
| Ctrl+O | Quick Switcher | 快速切换/搜索笔记 |
| Ctrl+N | 新建笔记 | 快速开始写作 |
| Ctrl+E | 切换编辑/预览 | 实时切换查看模式 |
| Ctrl+Shift+F | 全文搜索 | 全局内容检索 |
| Ctrl+B | 加粗 | /**/ 语法快捷操作 |
| Ctrl+I | 斜体 | /*/ 语法快捷操作 |
| Ctrl+K | 插入链接 | 快速添加外部链接 |
| Ctrl+D | 删除当前行 | 高效编辑操作 |
| Ctrl+Shift+↑/↓ | 移动当前行 | 调整内容顺序 |
7.3 Quick Switcher(快速切换器)
Quick Switcher 是日常使用频率最高的效率工具之一。按 Ctrl+O 打开后,输入笔记名称的一部分即可实时搜索并跳转。它还支持:
- 输入 #标签名 搜索标签
- 输入 @ 搜索最近打开的文件
- 输入 :命令名 直接执行命令
7.4 自定义快捷键
Obsidian 支持完全自定义快捷键。路径:Settings → Hotkeys。你可以为任何命令绑定快捷键,包括社区插件的命令。建议刚上手时先记忆上面表格中的 6-8 个核心快捷键,其余逐步添加。
8. 核心插件介绍 Core Plugins
Obsidian 内置了一系列核心插件(Core Plugins),无需安装即可使用。这些插件覆盖了知识管理的常见场景,且由官方维护,稳定可靠。以下逐一介绍最常用的8个核心插件。
画布(Canvas)
无限画布空间,自由放置笔记、图片、网页嵌入等元素,适合头脑风暴、思维导图和项目规划。
日记(Daily Notes)
一键创建当天日期命名的笔记,支持模板化每日记录,是GTD和晨间日记的完美工具。
模板(Templates)
预设笔记模板,创建新笔记时自动填充结构化内容,大幅提升笔记规范性。
大纲(Outline)
自动提取当前笔记的标题层级结构,支持拖拽调整顺序和快速跳转。
搜索(Search)
支持正则表达式、路径限定、标签过滤的高级全文搜索引擎。
文件恢复(File Recovery)
自动保存笔记历史版本,误删或误修改时可一键恢复,保障数据安全。
笔记重组(Note Composer)
将多篇笔记合并为一篇,或将一篇长笔记拆分为多篇,方便内容整理。
幻灯片(Slides)
将 Markdown 笔记直接转换为演示文稿,告别PPT制作困扰。
这些核心插件在安装 Obsidian 时默认启用。你可以在 Settings → Core plugins 中管理它们的开启/关闭状态。对于进阶用户,社区插件(Community Plugins)提供了超过2000款的扩展功能,涵盖 AI 写作、Zotero 文献管理、看板视图、数据查询(Dataview)等场景。
9. 笔记组织方法 Note Organization
有了工具和语法基础后,如何高效组织笔记就成为了下一个关键问题。Obsidian 提供了多种组织维度,合理组合使用可以构建出强大的知识管理体系。
9.1 文件夹结构
虽然 Bi-directional Links 弱化了文件夹的层级束缚,但合理的文件夹分类仍然有助于从宏观上管理笔记。建议采用扁平化结构,最多不超过3层:
Vault/
├── inbox/ <-- 临时收集箱(快速捕获)
├── daily/ <-- 日记
├── projects/ <-- 项目笔记
├── areas/ <-- 领域笔记
├── resources/ <-- 参考资料
└── archive/ <-- 归档
9.2 标签系统
标签是比文件夹更灵活的笔记分类方式。一条笔记可以拥有多个标签,从而实现多维度归类。在 Obsidian 中,使用 #标签名 即可创建标签。推荐采用"层级标签"结构:
#programming/python <-- 编程/Python
#programming/go <-- 编程/Go
#book/2026 <-- 书籍/2026年阅读
#project/obsidian <-- 项目/Obsidian专题
9.3 双向链接
如第5章所述,[[笔记名]] 是 Obsidian 中最强大的组织工具。链接让笔记从"文件夹中的文件"变为"网络中的节点"。建议在每篇笔记的底部设置一个"相关笔记"区域,主动建立链接关系。
9.4 属性(Properties)
Obsidian 支持在笔记开头添加 YAML 格式的属性元数据(Frontmatter),为笔记附加结构化信息:
---
title: Obsidian使用教程
created: 2026-01-15
tags: [obsidian, 教程, 知识管理]
status: 已完成
author: 火烈鸟站长知识库
---
搭配 Dataview 插件使用,这些属性可以转化为数据表格、统计图表、看板视图等,实现笔记的数据库化查询。
10. 知识管理方法论 Knowledge Management Methods
工具只是手段,方法论才是核心。以下三种被广泛验证的知识管理框架,可以在 Obsidian 中完美落地。
10.1 Zettelkasten(卡片笔记法)
由德国社会学家尼克拉斯·卢曼(Niklas Luhmann)发展出的笔记方法,核心原则有三:
- 原子化:每条笔记只记录一个概念或想法,保持独立聚焦。
- 自主链接:每条笔记都必须与其他笔记建立链接,形成知识网络。
- 用自己的话写:不要直接复制粘贴,用自己的语言重新表达才能内化知识。
在 Obsidian 中实践 Zettelkasten 极为自然:[[双向链接]] 天然对应着"链接",Graph View 完美呈现"知识网络",而 Markdown 的原子化文件结构正好契合"原子笔记"的要求。
10.2 PARA方法
由 Tiago Forte 在《Building a Second Brain》中提出的知识分类框架:
- P(Projects)— 项目:有明确截止日期的短期任务
- A(Areas)— 领域:需要持续关注的责任范围
- R(Resources)— 资源:感兴趣的主题或参考资料
- A(Archives)— 归档:已完成或不再活跃的内容
在 Obsidian 中实现 PARA 的最佳方式是结合"文件夹+标签+属性"三管齐下。文件夹用于宏观分类,标签用于跨领域标记,YAML 属性记录状态和元数据。
10.3 常青笔记(Evergreen Notes)
由 Andy Matuschak 提出的笔记原则,强调笔记应该是"持续生长"的:
- 笔记应该是概念导向的,而非主题导向
- 笔记应该持续修订,每次回顾时更新和优化
- 笔记应该紧密链接,新的笔记与已有笔记建立连接
- 笔记应该独立思考,即使脱离上下文也能被理解
💡 独特观点③
Zettelkasten 和 PARA 并非互斥,而是同一知识生命周期的不同阶段。 很多人纠结于"到底该用哪种方法",实际上,PARA 更适合知识的输入与组织阶段(分类存放),而 Zettelkasten 更适合知识的内化与创造阶段(建立关联)。在一个成熟的 Obsidian Vault 中,可以先用 PARA 框架收拢信息,然后通过 Zettelkasten 原则逐步将收拢的信息转化为相互链接的常青笔记——两者协同而非对立。
11. 常见问题 FAQ Frequently Asked Questions
以下整理了Obsidian使用教程中最常见的8个问题,结合独特观点和内链指引,帮助你更深入地理解和运用。
Q1:Obsidian 的 Vault 应该放在本地还是云盘?
建议本地存储 + 云盘自动备份。 Obsidian 官方推荐将 Vault 放在本地磁盘以获得最佳性能,然后通过 iCloud、Dropbox、OneDrive 或 Google Drive 等云盘实现自动同步备份。对于高级用户,可以使用 Git 进行版本控制(配合 Obsidian Git 插件)。需要注意:不要在 iCloud 和 Obsidian 同步服务之间同时启用,以免造成文件冲突。
→ 相关阅读:知识库搭建 | 本地部署
Q2:Obsidian 中的 Markdown 和 GitHub Flavored Markdown 一样吗?
大体一致,但有扩展。 Obsidian 完全支持标准 Markdown 和 GFM(GitHub Flavored Markdown)的核心语法,包括表格、任务列表、代码块等。额外扩展包括:[[双向链接]] 语法、==高亮== 语法、![[嵌入]] 语法、Callout 标注块、LaTeX 数学公式、Mermaid 图表等。这些扩展在标准 Markdown 解析器中不会被识别,但纯文本内容始终保持可读。
三步入门法:① 安装 + 创建 Vault;② 学习 Markdown 基础语法;③ 掌握 [[双向链接]]。 不要一开始就沉迷于插件安装和主题美化,先使用基础功能写10-20篇笔记,建立链接习惯后再逐步扩展。记住:Obsidian 的核心是知识管理,而非工具本身。
→ 相关阅读:下载安装 | Markdown语法 | 双向链接
Q4:Obsidian 的 Graph View 到底有什么用?值得关注吗?
Graph View 最有价值的用途不是"好看",而是"诊断"。 它能帮你快速发现知识库的结构问题:是否存在大量孤立节点(知识孤岛)?哪些笔记被引用最多(核心知识)?两个领域之间是否存在连接(跨学科潜力)?建议每周花5分钟浏览 Graph View 并主动为孤立节点建立链接,这是保持知识网络健康度的有效习惯。
→ 相关阅读:知识图谱详解 | Graph View操作
完全支持。 Obsidian 内置了对 LaTeX 数学公式的支持(使用 $...$ 行内公式或 $$...$$ 块级公式),以及 Mermaid.js 图表的渲染(包括流程图、时序图、类图、甘特图、饼图等)。只需在代码块中指定语言为 mermaid 即可绘制图表。这使得 Obsidian 非常适合学术笔记和技术文档写作。
Q6:如何在多个设备之间同步 Obsidian 笔记?
有四种主流同步方案: ① Obsidian Sync(官方方案,月费4美元,端到端加密,最稳定);② iCloud(苹果设备用户首选,免费,但 Windows 兼容性一般);③ Syncthing(开源点对点同步,免费,适合 Linux 用户);④ Git(配合 Obsidian Git 插件,适合开发者)。不推荐同时使用多个同步服务,容易引发文件冲突。
→ 相关阅读:本地部署方案
推荐 Top 5 必装插件: ① Dataview(将笔记变成数据库,支持 SQL-like 查询,推荐插件之首);② Templater(高级模板引擎,支持变量和脚本);③ Calendar(日历视图,配合日记使用);④ Excalidraw(手绘风格白板绘图);⑤ Obsidian Git(自动备份到 GitHub)。更多可选插件参见推荐插件页面。
→ 相关阅读:推荐插件 | GitHub插件 | AI插件
适合中小型项目的个人管理,大型团队协作建议搭配专业工具。 Obsidian 结合 Kanban 插件(看板视图)、Dataview 插件(任务查询)、Calendar 插件(时间线)、Templater 插件(项目模板),可以搭建出功能完善的项目管理看板。但需要注意的是,Obsidian 本身没有实时协同编辑能力,因此多人同时编辑的场景更适合 Notion、飞书、Linear 等协作工具。
→ 相关阅读:知识库搭建 | PARA方法