Obsidian 入门教程

这篇文章适合第一次接触 Obsidian 的 Windows 用户。

目标是把 Obsidian 最有用的部分跑起来：安装软件、创建笔记库、学会 Markdown、装好 Notebook Navigator 插件，然后用几个稳定的快捷键完成日常记录。

Obsidian 最大的优点是：你的笔记本质上就是一堆本地 Markdown 文件。即使以后不用 Obsidian，也可以用 VS Code、记事本或其他 Markdown 编辑器打开。对于经常使用代码的人来说，这一点符合直觉：文件可控、格式透明、迁移成本低。

本文主线以 Windows 为例。Obsidian 安装方式参考 Obsidian 官方下载与安装文档，社区插件安全说明参考 Obsidian Plugin security，Notebook Navigator 功能参考 Notebook Navigator 插件页 。

1. 安装 Obsidian

1.1 下载 Windows 版本

  1. 打开 Obsidian 官网下载页：obsidian.md/download
  2. 找到 Windows 区域。
  3. 点击 Universal 下载 Windows 安装包。
  4. 双击安装文件，按提示完成安装。
  5. 安装完成后，从开始菜单打开 Obsidian。

如果你习惯命令行，也可以用 Windows 的包管理器安装：

1
winget install Obsidian.Obsidian

但新手更推荐直接从官网下载。

1.2 创建你的第一个库

Obsidian 里一个“库”（Vault）就是一个文件夹。这个文件夹里会存放你的所有笔记、图片、附件和插件配置。

第一次打开 Obsidian 时，可以选择：

  1. 点击 Create new vault。
  2. 给库起一个名字，比如 My Notes。
  3. 选择一个本地目录，比如 D:\Notes\Obsidian。
  4. 点击 Create。

建议不要把库放在特别深、特别乱的目录里。你以后可能会用 Git、坚果云、OneDrive 或其他工具同步它，所以路径越清楚越好。

2. 先理解 Obsidian 的三个基础概念

2.1 笔记就是 Markdown 文件

在 Obsidian 里写笔记，本质上是在写 Markdown。常用语法就这几个：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# 一级标题
## 二级标题

**加粗文字**
*斜体文字*

- 无序列表
- 第二项

1. 有序列表
2. 第二项

`行内代码`

行内公式：$E = mc^2$

独立公式：
$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$

```python
print("hello obsidian")
```

Markdown 的好处是足够简单，也足够通用。你不用担心某个软件关停后笔记打不开，因为 .md 文件本身就是普通文本。Obsidian 也支持 LaTeX 风格的公式：短公式可以写在 $...$ 里，单独成段的公式可以写在 $$...$$ 里。

2.2 文件夹负责“收纳”

文件夹适合放确定归属的内容，例如笔者：

1
2
3
4
5
6
7
000 todo
100 paper
200 编曲
300 金融
400 阅读
900 随笔
999 模板

前面的数字不是必须的，但很实用。它可以让常用文件夹按你想要的顺序排列，而不是完全按拼音或英文排序。

一个简单原则是：

  • 临时想法先放 000 todo。
  • 已经稳定、有明确主题的笔记再移动到对应文件夹。
  • 不要一开始就设计十几层目录，目录太复杂反而会妨碍记录。

2.3 链接负责“关联”

Obsidian 的核心玩法是双链。你可以用两个方括号链接另一篇笔记：

1
今天遇到的问题和 [[JavaScript 异步编程]] 有关。

如果这篇笔记已经存在，点击链接就能跳过去。如果不存在，Obsidian 会在你打开它时创建新笔记。

这个功能特别适合记录问题链路：

1
这个报错可能和 [[Node.js 版本管理]]、[[pnpm 缓存]]、[[Windows 环境变量]] 有关。

过一段时间后，你会发现很多零散笔记开始互相连接。文件夹负责基本秩序，链接负责知识之间的真实关系。

3. 推荐先改的基础设置

打开设置，建议先检查这些位置：

进入 Settings -> Files and links。

建议开启或确认：

  • Automatically update internal links：重命名笔记时自动更新内部链接。
  • Default location for new notes：可以先设为 000 todo 这类收件箱文件夹。
  • Default location for new attachments：建议设为一个专门的附件目录，比如 _assets。

附件目录建议以下划线开头，例如：

1
_assets

后面配置 Notebook Navigator 时，可以把下划线开头的资源文件夹隐藏起来，左侧列表会干净很多。

3.2 Core plugins

进入 Settings -> Core plugins，建议确认这些核心插件是开启的：

  • Command palette：命令面板。
  • Quick switcher：快速打开笔记。
  • Backlinks：反向链接。
  • Graph view：关系图谱。
  • Templates：模板。
  • Page preview：鼠标悬停预览链接内容。

不用一次研究所有插件。先开这些，已经足够完成大部分日常记录。

4. 安装 Notebook Navigator 插件

Obsidian 默认的文件浏览器比较朴素。Notebook Navigator 的作用，是把左侧文件浏览器变成更像“笔记应用”的双栏导航：左边看文件夹和标签，右边看笔记列表、预览、标签、封面图。

它适合这些情况：

  • 你的笔记数量越来越多，默认文件树不够直观。
  • 你想同时用文件夹和标签管理笔记。
  • 你希望笔记列表能显示摘要、标签、缩略图或排序按钮。
  • 你想用键盘快速在文件夹、标签、笔记之间移动。

4.1 开启社区插件

社区插件是第三方代码。Obsidian 官方提醒：社区插件可以访问你的本地文件，也可能连接网络，所以只安装你信任的插件。

安装步骤：

  1. 打开设置。
  2. 进入 Community plugins。
  3. 如果看到 Restricted mode，点击 Turn on community plugins。
  4. 点击 Browse。
  5. 搜索 Notebook Navigator。
  6. 点击插件，选择 Install。
  7. 安装完成后点击 Enable。

启用后，左侧面板会被 Notebook Navigator 替换。你会看到更丰富的笔记列表：标题、预览文字、标签，如果笔记里有适合的图片，也可能显示特征图像。

5. Notebook Navigator 推荐配置

5.1 单栏和双栏

Notebook Navigator 的左侧区域分成两个窗格：

  • 导航窗格：快捷方式、最近文件、文件夹、标签。
  • 列表窗格：当前文件夹或标签下的笔记列表。

如果左侧面板太窄，它可能显示为单栏。你可以点击顶部的返回/切换按钮，让它变成双栏，再手动拖宽左侧面板。

双栏适合宽屏；如果你的屏幕较小，可以在插件设置里改成更紧凑的布局。

5.2 隐藏资源文件夹

如果你把图片、附件统一放在 _assets 这类目录里，建议隐藏它。

进入：

1
Settings -> Notebook Navigator -> Hidden folders

添加：

1
_*

含义是：隐藏根目录下所有以下划线开头的文件夹。

这样 _assets、_templates、_archive 之类的工具目录就不会挤在笔记列表里。需要临时查看时，可以点击 Notebook Navigator 顶部的 Show hidden files 按钮。

5.3 调整默认排序

进入：

1
Settings -> Notebook Navigator -> List pane

可以把默认排序改成：

1
Created date, newest first

也就是按创建时间倒序。这样最近新建的笔记会在最上面，适合日常输入。

如果你的笔记更像资料库，也可以选择按标题排序。重点是：默认排序用于大多数文件夹，特殊文件夹再单独覆盖。

5.4 理解“显示子文件夹中的笔记”

列表窗格顶部有一个非常重要的按钮：

1
Show notes from subfolders / descendants

开启后，当前文件夹和所有子文件夹里的笔记都会显示在同一个列表里。关闭后，只显示当前文件夹里的笔记。

举个例子：

1
2
3
4
100 Paper
├─ 项目 A
├─ 项目 B
└─ 项目 C

点击 100 Paper 时：

  • 开启：能看到项目 A、B、C 里的所有笔记。
  • 关闭：只看到 100 Paper 文件夹本身下的笔记。

如果你一打开 Notebook Navigator 就觉得“怎么所有笔记都挤出来了”，通常就是这个按钮开启了。

标签也是同理。比如 #ai 下还有 #ai/agent、#ai/rag：

  • 开启 descendants：会显示 #ai 以及子标签下的笔记。
  • 关闭 descendants：只显示精确标了 #ai 的笔记。

5.5 设置紧凑列表

如果你喜欢更像文件管理器的视图，可以进入：

1
Settings -> Notebook Navigator -> List pane -> Appearance

尝试：

  • 列表模式改为 compact。
  • 减少预览行数。
  • 显示文件类型图标。
  • 减少标题行数。

如果你更想把它当作“笔记卡片列表”，就保留预览文字和图片。知识库越偏资料管理，列表越适合紧凑；越偏阅读整理，预览越有价值。

5.6 使用快捷方式区域

Notebook Navigator 左上角有 Shortcuts 区域，可以放常用笔记、文件夹、标签和保存的搜索。

添加方式有几种：

  • 把笔记拖到 Shortcuts。
  • 右键笔记，选择添加到 Shortcuts。
  • 把文件夹或标签拖进去。
  • 搜索后保存为搜索快捷方式。

建议先放这些：

  • 000 todo
  • 当前最重要的项目文件夹
  • #todo
  • #bug
  • 一篇“今日工作记录”

你还可以给前几个 Shortcut 绑定热键。进入：

1
Settings -> Hotkeys

搜索：

1
Notebook Navigator shortcut

可以绑定成：

1
2
3
Ctrl + 1
Ctrl + 2
Ctrl + 3

这样就能像浏览器标签页一样快速跳到最常用的笔记或文件夹。

5.7 让新笔记创建在当前选中的文件夹

这是 Notebook Navigator 很实用的一点。

Obsidian 默认新建笔记的位置通常由全局设置决定，比如总是放到收件箱。但当你正在 Notebook Navigator 里选中某个文件夹时，你可能希望新笔记直接建在这个文件夹里。

进入：

1
Settings -> Hotkeys

搜索 Notebook Navigator 的新建笔记命令，把它绑定到你顺手的快捷键，比如：

1
Ctrl + Alt + N

以后你在 Notebook Navigator 里选中某个文件夹，再按这个快捷键，新笔记就会创建到当前文件夹里。

5.8 搜索和标签过滤

Notebook Navigator 列表窗格顶部有搜索按钮。你可以：

  • 搜索文件名关键词，比如 React。
  • 搜索标签，比如 #bug。
  • 搜索没有某个标签的笔记，比如用插件支持的否定标签过滤。
  • 找出没有标签的笔记，再批量整理。

一个好用的工作流是：

  1. 搜索 #todo。
  2. 把结果保存为 Shortcut。
  3. 每天点这个 Shortcut 处理待办。

如果你经常按某个关键词或标签组合查找，比如 Sony + #photo、React + #bug，保存搜索比每次重新输入更省心。

5.9 固定重要笔记

如果某个文件夹里笔记很多，但你总要打开其中几篇，可以右键笔记选择 Pin note。

固定后，它会出现在列表顶部。适合固定：

  • 项目总览
  • 课程大纲
  • 长期任务清单
  • 本周计划
  • 常用代码片段索引

6. Windows 常用快捷键

视频里很多操作使用的是 macOS 的 Command。在 Windows 上，大多数情况要换成 Ctrl。

下面这张表可以先记住：

操作 Windows 快捷键
打开设置 Ctrl + ,
打开命令面板 Ctrl + P
快速打开笔记 Ctrl + O
新建笔记 Ctrl + N
当前笔记内搜索 Ctrl + F
全库搜索 Ctrl + Shift + F
打开关系图谱 Ctrl + G
编辑/阅读模式切换 Ctrl + E
加粗 Ctrl + B
斜体 Ctrl + I
插入外部链接 Ctrl + K
前进/后退 Ctrl + Alt + 左/右方向键
打开新标签页 Ctrl + T
关闭当前标签页 Ctrl + W

有两个快捷键尤其重要：

6.1 Ctrl + O：快速打开笔记

这是日常使用频率最高的快捷键之一。按下后输入关键词，就能快速跳到某篇笔记。

比如输入：

1
aws

它会列出标题里匹配 aws 的笔记。对于程序员来说，这比在文件树里一层层点开快很多。

6.2 Ctrl + P：打开命令面板

命令面板可以搜索 Obsidian 的所有命令，包括插件命令。

例如你想插入模板：

  1. 按 Ctrl + P。
  2. 输入 模版。
  3. 选择插入模板的命令。
  4. 选择模板文件。

如果某个功能你不知道在哪个菜单里，先按 Ctrl + P 搜命令，通常比翻设置更快。

注意：不同版本、不同插件可能会占用不同热键。最可靠的方法是进入 Settings -> Hotkeys 搜命令名，然后按自己的习惯重新绑定。

7. 给程序员的笔记方法

7.1 不要过度设计

很多人第一次用 Obsidian，会忍不住先研究标签体系、Zettelkasten、PARA、Dataview、自动化模板。结果工具越配越复杂，真正写下来的笔记反而很少。

更推荐的起步方式是：

1
先能记 -> 再能找 -> 最后再优化结构

你的第一版系统只需要三个入口：

  • 000 todo：所有临时记录。
  • 200 编程：稳定的技术笔记。
  • 300 项目：和具体项目有关的记录。

等你真的有几十篇、几百篇笔记，再整理也不晚。

7.2 用“每日工作记录”承接零散信息

程序员每天会遇到很多碎片：

  • 一个奇怪的报错。
  • 一个命令行参数。
  • 一个 Stack Overflow 结论。
  • 一个 Git 操作。
  • 一个临时 TODO。
  • 一个接口返回异常。

建议每天建一篇：

1
2026-05-07 工作记录

内容不用正式，先用 bullet list 记下来：

1
2
3
4
5
6
# 2026-05-07 工作记录

- 修复登录页跳转问题，原因是 redirect 参数没有 encode。
- pnpm install 失败，最后通过清理 store 解决：`pnpm store prune`
- 发现一个后续要整理的点：[[Windows 环境变量优先级]]
- TODO: 把 Obsidian 插件配置整理成教程。

以后搜索报错、命令、项目名时，这些记录会救你很多次。

7.3 用链接把临时记录变成长期知识

每日记录是入口，不是终点。遇到值得沉淀的内容，就给它建一篇独立笔记。

比如你当天写了：

1
- pnpm install 失败，最后通过清理 store 解决：`pnpm store prune`

可以改成：

1
- pnpm install 失败，整理到 [[pnpm store 缓存问题]]。

然后在 [[pnpm store 缓存问题]] 里写：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# pnpm store 缓存问题

## 现象

执行 `pnpm install` 时依赖解析异常，重复安装仍然失败。

## 处理

```powershell
pnpm store prune
pnpm install
```

## 适用场景

- 怀疑本地 pnpm store 损坏。
- 切换项目后依赖状态异常。

这就是从“流水账”到“可复用知识”的过程。

7.4 给课程和项目做模板

打开核心插件 Templates 后，可以新建一个模板文件夹：

1
_templates

然后创建一个课程笔记模板：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
---
type: class-note
date: {{date}}
tags: [course]
---

# {{title}}

## 主题

## 关键概念

## 示例代码

## 疑问

## 后续阅读

项目问题模板可以这样写：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
---
type: bug-note
date: {{date}}
tags: [bug]
---

# {{title}}

## 背景

## 现象

## 排查过程

## 解决方案

## 复盘

使用时按 Ctrl + P，搜索 template，插入对应模板即可。

7.5 标签不要太多

标签适合表达状态或横向属性，不适合完全替代文件夹。

推荐先用少量标签：

1
2
3
4
5
6
#todo
#bug
#idea
#reading
#project
#course

技术栈也可以做标签，但不要太碎：

1
2
3
4
5
#python
#javascript
#react
#linux
#windows

如果你每篇笔记都要想半天该打什么标签，说明标签体系太重了。

7.6 搜索比分类更重要

真正高频的动作不是“把笔记分类得完美”，而是“需要时能找到”。

所以写笔记时可以故意加一些未来会搜索的关键词：

1
2
3
4
5
6
## 报错关键词

Cannot find module
permission denied
ECONNRESET
certificate has expired

以后按 Ctrl + Shift + F 全库搜索这些关键词，通常就能找到当时的解决记录。

8. 一个适合新手的完整工作流

你可以直接照这个流程用一周：

  1. 每天新建一篇工作记录。
  2. 所有临时内容先写进去，不纠结格式。
  3. 重要问题用 [[双链]] 建独立笔记。
  4. 独立笔记整理到对应文件夹。
  5. 用 Notebook Navigator 把 000 Inbox、本周项目、#todo 放进 Shortcuts。
  6. 每周清理一次 Inbox，把有价值的内容沉淀成长期笔记。

文件夹结构可以先用：

1
2
3
4
5
6
7
000 todo
100 Paper
200 编程
300 项目
400 阅读
_assets
_templates

Notebook Navigator 设置可以先用：

1
2
3
4
Hidden folders: _*
Default sort: Created date, newest first
List mode: Standard 或 Compact
Shortcuts: Inbox / 当前项目 / #todo / 今日工作记录

快捷键先记：

1
2
3
4
5
Ctrl + O        快速打开笔记
Ctrl + P        搜索命令
Ctrl + N        新建笔记
Ctrl + Shift+F  全库搜索
Ctrl + ,        打开设置

这套已经够用了。先写起来，系统会在使用中自然长出来。

9. 常见问题

9.1 要不要一开始就同步？

如果只有一台电脑，可以先不同步。等你确定会长期使用，再考虑同步。

常见方案：

  • Obsidian Sync：官方同步，省心但付费。
  • OneDrive / 坚果云：适合普通文件同步，但要注意冲突文件。
  • Git：适合程序员，但图片和大文件多时要谨慎。
  • Gitsync：可以在移动端查看笔记、修改

不管用哪种方式，都建议先定期备份整个 Vault 文件夹。

9.2 插件是不是装得越多越好？

不是。

新手阶段建议先少装插件。Notebook Navigator 已经会改变你的主界面，先把它用熟，再考虑 Dataview、Tasks、Calendar、Templater 等插件。

插件越多，快捷键冲突、界面复杂度和维护成本也越高。

9.3 文件夹、标签、链接到底用哪个？

可以这样分工：

  • 文件夹：这篇笔记主要属于哪里。
  • 标签：这篇笔记现在是什么状态、有什么属性。
  • 链接：这篇笔记和哪些概念有关。

比如一篇笔记放在：

1
300 项目/博客系统/部署问题.md

里面可以有：

1
2
3
tags: [bug, deploy, windows]

这个问题和 [[GitHub Actions]]、[[Hexo 部署]]、[[Windows PowerShell]] 有关。

三者并不冲突。

9.4 Notebook Navigator 列表里东西太多怎么办？

优先检查三个地方：

  1. 是否开启了 Show notes from subfolders / descendants。
  2. 是否没有隐藏 _assets 之类的资源文件夹。
  3. 当前文件夹或标签是否范围太大。

如果只是临时想聚焦，可以用搜索或保存搜索快捷方式。

10. 最后建议

Obsidian 最容易让人上头的地方，是它看起来可以被无限配置。但对笔记系统来说，真正重要的是持续记录。
只需要做到：

  • 今天的问题能记下来。
  • 下次遇到同类问题能搜出来。
  • 重要知识能慢慢整理成独立笔记。
    当这三件事成立，Obsidian 就已经开始发挥价值了。Notebook Navigator 只是让这个过程更顺手：更好浏览、更快搜索、更容易在文件夹和标签之间切换。先让笔记活起来，系统自然就变漂亮。