Obsidian 基础教程（一）

这份教程面向第一次使用 Obsidian 的用户，目标是让你能从零开始建立一个稳定的笔记库，并掌握日常高频功能：写、找、连、复用、整理。

1. Obsidian 是什么

Obsidian 是一个本地优先的笔记应用：

• 笔记以纯文本 Markdown 文件保存（可长期可迁移）。

• 可以用 [[双向链接]] 把笔记连接成网络（更适合知识管理与长期积累）。

• 功能主要由内置功能和插件系统构成（可从轻到重逐步升级）。

2. 三个核心概念：库、笔记、链接

2.1 库（Vault）

• 一个 Vault 就是一个文件夹。

• 里面的每个 .md 文件都是一条笔记。

• 你可以用任意同步/备份工具处理这个文件夹（前提是理解冲突与规则，见后文）。

2.2 笔记（Note）

建议把“笔记”理解为一种可组合的内容单元，而不是文章或文档：

• 短笔记：一个概念、一条记录、一个任务。

• 长笔记：一个主题的汇总页（MOC/索引页），把短笔记组织起来。

2.3 链接（Link）

Obsidian 的关键价值在于链接：

• [[A]] 链接到 A 这条笔记（不存在会自动创建）。

• 从 A 到 B 的链接会在 B 上形成反向链接。

• 反向链接 + 搜索 + 索引页，能让笔记越写越好找。

3. 建议的库结构与命名

不要一开始就追求完美结构，先保证“写得下去、找得到、能收敛”。

4. 界面速览与常用面板

常用区域通常包括：

• 文件浏览器：文件夹与笔记列表

• 搜索：全文搜索、条件组合

• 大纲：根据标题生成结构导航

• 反向链接：查看哪些笔记链接到了当前笔记

3.1 推荐的最小结构

你可以从这 4 类开始（按需增减）：

• 00-Inbox/：临时收集，快速记录，后续再整理

• 01-Notes/：相对稳定的内容笔记（概念、方法、总结）

• 02-Projects/：项目页、会议纪要、任务推进

• 99-Attachments/：图片、PDF、音频等附件

3.2 命名建议

• 尽量使用稳定、可搜索的标题：例如 01. Obsidian 基础教程、GTD 工作流、读书笔记：XX

• 如果经常引用某笔记，标题尽量唯一，避免同名导致链接歧义。

• 项目/会议建议加日期前缀：2026-01-17 周会纪要

4.1 两个高频操作

• 快速打开：通过快速切换（Quick switcher）用标题快速跳转

• 命令面板：几乎所有功能都能通过命令面板触发

5. Markdown 快速上手

Obsidian 用的是 Markdown（写作语法），下面是日常最常用的一小套。

5.1 标题与分割线

# 一级标题
## 二级标题
### 三级标题

---

5.2 列表与任务

- 无序列表
  - 子项

1. 有序列表
2. 第二项

- [ ] 待办
- [x] 已完成

5.3 引用、代码与表格

> 这是一段引用

`行内代码`

```js
console.log("code block")
```

| 列1 | 列2 |
| --- | --- |
| A   | B   |

5.4 图片与链接

![[image.png]]
![说明文字](https://example.com/image.png)

[外部链接](https://example.com)

说明：

• ![[...]] 是 Obsidian 的“内部嵌入”语法（对附件/笔记都适用）。

• 外部图片链接需要网络；本地附件更稳定。

6. 链接、别名、嵌入与块引用

6.1 内部链接

[[某条笔记]]
[[某条笔记#某个标题]]

6.2 显示文本（管道语法）

[[某条笔记|我想显示成这个名字]]

6.3 嵌入笔记或段落

![[某条笔记]]
![[某条笔记#某个标题]]

嵌入适合“复用内容”，例如把统一定义、模板段落、项目状态块嵌入到多个页面。

6.4 块引用（Block Reference）

块引用用于精确引用某一段内容。

做法（其中 ^id 是块标识）：

这是一段可以被引用的内容。 ^definition

在其他笔记引用：

![[某条笔记#^definition]]

7. 反向链接、未链接提及与图谱

7.1 反向链接（Backlinks）

当你在 A 中写了 [[B]]，B 中就会看到 “A 链接到了 B”。这会自然形成“被引用的上下文”。

使用建议：

• 写完一条笔记后，习惯性查看反向链接面板

• 通过反向链接找“应该补充连接的地方”，让知识网络更密

7.2 未链接提及（Unlinked mentions）

很多时候你会在文本里写到某个概念，但没加链接。未链接提及可以帮你把它们补成链接，提升可导航性。

7.3 图谱（Graph）

图谱适合做两件事：

• 局部图谱：看“当前笔记周边”与关联结构

• 全局图谱：检查孤立笔记、主题聚类

图谱不是越大越好，建议结合过滤器，只看你关心的标签/文件夹/链接深度。

8. 标签、属性（Properties）与元数据

8.1 标签（Tags）

标签适合做“横向切片”：

• #方法、#工具、#读书笔记、#项目/进行中

建议：

• 标签不要太多太细，优先用链接与索引页组织内容

• 只给未来会用来筛选/聚合的东西加标签

8.2 属性（Properties）

属性是结构化元数据，可以写在笔记顶部（也可用 UI 直接维护）。常见字段：

• title：显示标题

• tags：标签数组

• created / updated：创建/更新时间

• type：笔记类型（note / project / people / book …）

• status：状态（draft / active / done …）

示例：

---
title: 读书笔记：某某
type: book-note
tags: [读书笔记]
created: {{date}}
---

9. 搜索：把“找得到”做到极致

Obsidian 的搜索不仅能搜关键字，还能组合条件。建议你至少掌握这些用法：

9.1 基础搜索

• 直接输入关键字：全文匹配

• 用引号：精确短语匹配

9.2 常用筛选

思路是先缩小范围再搜内容：

• 限定文件夹：只在某个目录内查

• 限定标签：只看某类笔记

• 限定标题：只查标题含某词的笔记

如果你经常重复同一类搜索，可以把搜索保存下来当作“动态列表”。

10. 高频内置功能：日记、模板、命令面板、书签

10.1 日记（Daily notes）

日记是最容易坚持的入口，用来承接临时记录：

• 今天做了什么

• 突然想到的灵感

• 会议记录与待办

建议把日记当作 “00-Inbox 的每日版本”，再定期把内容整理到主题笔记或项目笔记里。

10.2 模板（Templates）

模板用来减少重复劳动。你可以准备几个最常用模板：

• 会议纪要模板

• 读书笔记模板

• 项目周报模板

一个简单的会议纪要模板示例：

---
type: meeting
tags: [meeting]
status: draft
date: {{date}}
created: {{date}}
---

# {{title}}

## 结论

## 纪要

## 待办
- [ ]

10.3 命令面板（Command palette）

当你不知道某功能在哪时，用命令面板搜功能名是最快的方式。

10.4 书签（Bookmarks）

把常用入口固定下来：

• 常用索引页（MOC）

• 当前项目主页

• 常用搜索

11. 附件与图片：不乱才好用

建议尽早设置附件策略，否则库越大越难整理。

一个常见策略：

• 所有附件统一放到 99-Attachments/

• 通过嵌入语法引用：![[xxx.png]]

如果你希望“笔记与附件同目录”，也可以采用每个项目一个文件夹的方式，但要从一开始就统一规则。

12. 同步与备份：重要但容易踩坑

Obsidian 是本地文件，理论上任何同步工具都能用，但要注意两类风险：

• 同步冲突：多设备同时编辑同一文件容易冲突

• 隐藏文件/插件配置：不同同步工具对隐藏文件支持不同

建议策略（从易到稳）：

• 单设备使用：定期把 Vault 复制到备份盘/云盘

• 多设备同步：尽量避免多端同时编辑同一条笔记

• 如果你用 Git：把“文本类笔记”纳入版本控制，附件按需处理（大附件可能需要额外方案）

13. 一个可直接照抄的日常工作流

13.1 捕获（Capture）

• 所有临时想法写到日记或 00-Inbox/

• 标题先随便起，但要能搜到

13.2 整理（Process）

每天或每周花 15–30 分钟把 Inbox 清空：

• 能归档到某主题：移动到 01-Notes/ 并加上必要链接

• 属于某项目：放进项目主页，并补充下一步行动

• 没价值：删除或合并

13.3 连接（Connect）

整理时强制做一件事：至少加 1–3 个链接：

• 链接到概念定义

• 链接到相关项目

• 链接到索引页（MOC）

13.4 汇总（Synthesize）

当某主题笔记变多时，建立一个索引页（MOC）：

---
type: moc
tags: [MOC]
created: {{date}}
---

# Obsidian MOC

## 基础
- [[Obsidian 基础教程]]
- [[Markdown 速查]]

## 工作流
- [[日记系统]]
- [[模板系统]]

索引页不追求完美，只追求“能把你带到需要的地方”。

14. 常见问题（FAQ）

14.1 为什么我移动/重命名文件后链接会乱？

通常是设置问题。一般建议开启“自动更新内部链接”，这样移动/重命名会自动维护链接引用。

14.2 什么时候用标签，什么时候用链接？

一个实用规则：

• 用链接：表达“内容关系”（A 与 B 相关）

• 用标签：表达“分类/状态/过滤”（用来筛选聚合）

14.3 笔记越写越多，怎么不迷路？

按优先级做三件事：

• 用搜索解决“找”

• 用反向链接解决“上下文”

• 用索引页解决“结构”