Obsidian 快速使用入门

什么是 Obsidian

Obsidian 是一款基于本地 Markdown 文件的知识管理工具。所有笔记以 .md 文件形式存储在本地文件夹中，不依赖云端服务，数据完全由用户掌控。

其核心特性是双向链接——通过 [[]] 语法在笔记之间建立关联，形成知识网络，而非传统的树形目录结构。

安装与初始化

下载安装

从官网 obsidian.md 下载对应平台安装包，支持 Windows、macOS、Linux、iOS、Android。

创建 Vault

Vault（仓库）是 Obsidian 管理的一个文件夹，所有笔记都存放在其中。

1. 打开 Obsidian → 选择「创建新仓库」
2. 指定仓库名称和存储路径
3. 点击「创建」

创建后，该文件夹下会生成 .obsidian/ 隐藏目录，存放配置、插件和主题数据。

核心概念

Vault（仓库）

一个本地文件夹即一个 Vault。Obsidian 以 Vault 为单位管理笔记，不同 Vault 之间的配置和插件相互独立。

笔记

每个笔记就是一个 .md 文件。可以用任何文本编辑器打开，不被 Obsidian 绑定。

链接

Obsidian 使用 [[文件名]] 语法创建笔记间的内部链接。这是构建知识网络的核心。

1
2
3

[[C语言]] - 链接到 C语言.md
[[C语言|C 语言]] - 显示为「C 语言」
[[C语言#指针]] - 链接到 C语言.md 的「指针」章节

标签

用 #标签名 为笔记添加分类标记。可以放在正文中（内联标签）或 frontmatter 的 tags 字段中。

1
2
3
4
5

---
tags:
  - 嵌入式
  - FOC
---

Frontmatter

笔记开头用 --- 包裹的 YAML 块，用于存储元数据（标签、日期、自定义属性等）。

1
2
3
4
5
6

---
tags:
  - c
  - 编码规范
date: 2026-04-06
---

基本操作

创建笔记

• Ctrl + N：新建笔记
• 在编辑器中输入 [[新页面名]]，按住 Ctrl 点击链接，自动创建新笔记

编辑模式

Obsidian 支持两种模式：

• 实时预览（默认）：所见即所得，编辑时即时渲染
• 源码模式：显示原始 Markdown 源码

切换方式：点击右上角编辑器菜单，或使用 Ctrl + E。

搜索

• Ctrl + Shift + F：全局搜索
• Ctrl + O：快速打开文件（模糊匹配）
• Ctrl + P：命令面板（搜索并执行任意命令）

分屏

• 按住 Ctrl 点击链接：在新面板中打开
• 拖拽标签页到编辑器边缘：实现左右/上下分屏

双向链接

基本链接

1

[[笔记名称]]

链接到 Vault 中同名的 .md 文件。Obsidian 会自动匹配，无需写路径。

别名

1

[[笔记名称|显示文本]]

链接目标不变，但页面上显示为自定义文本。

链接到标题

1
2

[[笔记名称#二级标题]]
[[笔记名称#二级标题|自定义文本]]

嵌入

用 ! 前缀将另一个笔记的内容直接嵌入当前笔记：

1
2
3
4

![[笔记名称]] - 嵌入整篇笔记
![[笔记名称#章节]] - 嵌入指定章节
![[图片.png]] - 嵌入图片
![[图片.png|300]] - 嵌入图片并指定宽度

反向链接

点击笔记右侧的「反向链接」面板，可以看到所有链接到当前笔记的其他笔记，无需手动维护。

常用核心插件

在「设置 → 核心插件」中启用或关闭。

推荐社区插件

在「设置 → 社区插件 → 浏览」中搜索安装。

目录结构建议

1
2
3
4
5
6
7
8
9
10
11
12
13

vault/
├── 首页.md              # 知识库导航入口
├── C语言/
│   ├── C语言.md          # MOC 索引页
│   ├── 基础语法/
│   └── 编码规范/
├── 嵌入式开发/
│   ├── 嵌入式开发.md
│   └── FOC矢量控制/
├── 工具指南/
│   ├── 工具指南.md
│   └── ...
└── .obsidian/            # 配置目录（自动生成）

组织原则：

• 每个主题目录放一个同名 MOC（Map of Content）文件作为索引
• MOC 文件用 [[]] 链接到目录下的所有笔记
• 首页链接到所有 MOC 页面，形成两层导航
• 用标签补充分类，不完全依赖目录结构

快捷键速查

编辑

导航

窗口