知识管理工具 Obsidian 完整指南和插件推荐

给大家推荐一个本地笔记和知识管理工具：Obsidian。

Obsidian 界面

特点大概有如下这些：

• · 免费，本地软件，容易安装

• · 体积小、速度快

• · 支持多操作系统，不依赖其他软件和工具

• · 使用本文编写、支持多目录、支持标签、支持文件属性、支持文件双向引用

• · 支持多种数据格式转换，方便笔记记录和迁移

• · 方便备份和同步（多设备之间）

• · 支持检索、支持多语言

• · 支持多主题

• · 支持插件（极其丰富的插件系统）

文章主要内容如下，大家可以挑选自己感兴趣的看：

• · 主页和安装

• · 创建 Vault 和主题选择

• · 如何写笔记

• · 命令、标签、链接、幻灯片等

• · 备份、同步

• · 笔记重组

• · 工作区使用

• · 25个常用插件

主页和安装

打开 Obsidian 的主页^[1]，下载你操作系统对应的版本安装。

剩下的就和正常的软件安装没啥区别了。安装好之后打开应用即可。

创建 Vault 和主题选择

Obsidian 首先要创建一个 Vault，一个 Vault 你可以理解成一个笔记项目， 里面可以包括多个文件夹和多个文件。

File->Open Vault 创建或者打开一个 Vault：

然后我们看到欢迎界面如下：

设置->外观->主题 选择主题。

找到喜欢的主题，点击安装，

等安装成功之后查看效果：

右侧是图谱的显示，如果找不到相应选项，可以去设置->核心插件->关系图谱 开启对应选项。

文件管理

左侧目录上方有两个我们最常用的按钮，一个是 新建文件，

另一个是新建文件夹：

文件夹可以嵌套，

每个文件夹下面都可以创建多个文件，我们还可以拖动文件和文件夹了调整目录结构。

或者点击文件或者文件夹的右键菜单来操作：

单开文件位置，可以看到在操作系统上生成了同样结构的目录和文件：

也就是说，在 Obsidian 里面操作文件夹，和操作系统的文件管理器是一样的， 并且每个笔记都是用.md格式来存储。

我们查看 欢迎.md 文件查看内容，

发现和我们编辑器里面一样。

写笔记

Obisidian 里面的笔记都是 .md 格式的文件， 也就是说 Obisidian 里面的笔记都是 Markdown 格式的。

我们可以从 帮助->打开帮助 打开帮助，

然后点击浏览帮助文档，如果打开默认可能是英文，我们可以选择中文模式：

打开编辑与格式化->基本格式语法 可以快速学习一下怎么使用 Markdown 来进行排版：

标题

要创建小标题，在小标题文本前添加至多六个 # 符号。# 符号的数量决定了小标题的级别。

# 这是标题 1

## 这是标题 2

### 这是标题 3

#### 这是标题 4

##### 这是标题 5

###### 这是标题 6

效果可能如下：

样式具体的现实样式基于你选择的主题可能会有所不同。

段落和空格

Markdown 使用空行来区分段落，一个空行和多个空行的效果一样。

这是一个段落。

这是另一个段落。

这是第三个段落。

排版结果如下：

文章中的多个空格也会被视为一个空格：

多个 相邻 空格 

排版效果如下：

字体样式

Markdown 也支持 粗体、斜体、删除线、高亮、粗体和斜体嵌套等字体样式。

样式	语法	示例	输出
粗体	** **或__ __	**粗体文本**	粗体文本
斜体	* *或_ _	*斜体文本*	斜体文本
删除线	~~ ~~	~~删除线文本~~	删除线文本
高亮	== ==	==高亮文本==	==高亮文本==
粗体和嵌套斜体	** **和_ _	**粗体和 _嵌套斜体_ 文本**	粗体和嵌套斜体文本
粗体和斜体	*** ***或___ ___	***粗体和斜体文本***

如果想打特殊符号不想让文本格式化，可以使用 \ 来实现：

\*\*这里的加粗不会真正的加粗\*\*

会有如下输出：

文章链接

Obsidian支持两种风格的内部链接：

Wiki 链接风格：[[欢迎]]

Markdown 链接风格：[欢迎](欢迎.md)

内部链接内部链接值当前 Vault 内的文件。

效果如下，鼠标放到链接上可以预览文件，点击跳转到对应的文件：

链接到标题

我们还可以链接到页面的某个标题，在文件名称后面添加 #（#）和标题的名称，如果是当前笔记的标题，直接添加 #（#）即可。

[欢迎#title2](欢迎.md#title2)

[[#title2]]

预览和点击的效果都会指向文件的标题：

外部链接

如果要链接到外部URL，可以通过在方括号（[ ]）中填入描述链接的文本，然后在括号中（()）添加URL来创建内联链接。

[Obsidian帮助](https://help.)

你也可以通过Obsidian URI创建指向其他仓库的文件的外部链接。

笔记^[2]

引用

引用也是很常用的一个功能，你可以在文本前加上 > 符号来引用文本。

> 人类面临着越来越复杂和紧迫的问题，他们有效应对这些问题的能力对于社会的稳定和持续发展至关重要。
>
>\- 道格·恩格尔巴特，1961

你也可以为引用增加标题变成标注：

> [!人类发展]
> 人类面临着越来越复杂和紧迫的问题，他们有效应对这些问题的能力对于社会的稳定和持续发展至关重要。
>
>\- 道格·恩格尔巴特，1961

或者指定引用的类型：

[!error] 人类发展 人类面临着越来越复杂和紧迫的问题，他们有效应对这些问题的能力对于社会的稳定和持续发展至关重要。

- 道格·恩格尔巴特，1961

可以是 tip error faq warnning note abstract summary todo info 等前缀， 完整值可以参考 Obsidian标注文档^[3]。

你可以通过在类型标识符后添加加号（+）或减号（-）来使标注可折叠。

加号表示标注默认展开，减号表示标注收起。

> [!faq]- 标注可以折叠吗？
> 可以！在可折叠标注中，当标注收起时，内容会被隐藏。

列表

你可以在文本前加上 -、* 或 + 来创建无序列表。两个空格表示缩进（嵌套）。

- 第一条
- 第二条
    - 第2.1条
    - 第2.2条
- 第三条

要创建有序列表，每行以数字加上 . 开头。

1. 第一条
2. 第二条
    1. 第2.1
    2. 第2.2
3. 第三条

任务

要创建任务列表，每个列表项以连字符和空格开头，后跟 [ ]。

括号中的任意字符都表示完成，只有 x 的完成状态会用删除线表示。

任务列表也可以缩进和嵌套。

- [x] 这是已完成的任务。
- [-] 这是已完成的任务。
    - [-] 这是已完成的任务。
    - [-] 这是已完成的任务。
- [ ] 这是未完成的任务。

分割线

我们有多种方式表示分割线：

*** 
**** 
* * *
--- 
---- 
- - - 
___ 
____ 
_ _ _

不过一般情况我们都是用三个连接符 --- 表示。

笔记属性

你可以通过属性这个功能来组织笔记。 属性包含很多结构化的数据，如文本、链接、日期、复选框和数字。 属性还可以与第三方插件结合使用， 这些插件可以处理笔记的属性数据并完成一些有用的操作。

有几种方法向笔记中添加属性：

• · 使用添加文件属性命令。

• · 使用Cmd/Ctrl+;快捷键。

• · 从更多操作菜单中选择添加文件属性（通过三个点图标或右键单击标签页）。

• · 在笔记的开头输入---。

填入属性名称，和属性值按回车即可。

属性值不支持包含空格，建议使用英文单词或中文单词。如果需要多个值，点击回车继续添加即可。

属性支持类型，可以点击属性名称前面的图标选择：

属性类型注意属性类型是全局的，一旦选择了属性类型，所有同一个名称的属性都被设定为该类型。

Obsidian 提供了几个内置的属性：tags（标签）、cssclasses（样式）和aliases（别名）。

标签

上面提到系统内置的属性 tags，可以用来分类笔记。除了在文件属性中添加标签，你也可以在文章内容中添加标签。

只需要 # 后面跟着标签名称即可。

这是标签 #markdown 的使用。

命令面板

命令面板是我们最常用的功能之一，所有 Obsidian 的神奇功能都可以通过该方式使用。

在 Obsidian 中，你可以通过键盘直接执行许多命令。命令面板允许你在同一个交互窗口中执行任何命令。同时，在命令面板中，你还可以探索所有命令的快捷键。

要在命令面板中执行命令：

• · 按下Ctrl+P（在 macOS 上为Cmd+P）以打开命令面板。

• · 输入你想运行的命令名称。

• · 使用箭头键导航到该命令。

• · 按下Enter。

斜杠命令

Obsidian 还可以让你在编辑笔记时，在行首或在空格后输入斜杠 (/) 来执行命令。

默认斜杠命令是没有开启的，我们可以去核心插件开启该功能。

然后就可以在编辑器中使用 / 来快速呼出命令面板了。

模糊匹配类似于命令面板，斜杠命令支持模糊匹配。 即使你不知道命令的确切名称，也可以搜索到命令。 例如，输入 'scf' 可以找到Save current file（保存当前文件）命令。（ 对于中文来说，输入命令的一部分也可以找到相应命令）

笔记模板

创建笔记的时候可以使用模板，这样模板中的属性就会自动带入到笔记中。

打开 设置->核心插件->模板，然后设置模板文件夹的位置：

回到系统界面，在模板文件夹中设置新增模板文件，模板文件和普通的笔记文件一样。

然后切换一个笔记文件，点击插入模板，

然后选择模板即可。

然后你在模板中定义的属性和笔记内容就会被复制到当前笔记中。

文件模板还可以使用变量哦，但是变量仅在插入的一瞬间生效。

变量	描述
{{title}}	当前笔记的标题。
{{date}}	当前日期。默认格式： YYYY-MM-DD。
{{time}}	当前时间。默认格式： HH:mm。

基本操作

现在看一下 Obsidian 的基本操作。

笔记书写模式和预览模式的切换：

笔记分屏操作：

侧边栏的文件大纲：

反向链接

反向链接是一个很好用的功能，可以查看某个文件在其他文件中的引用。

比如我们打开一个文件，点击右上角的侧边栏，选择 反向链接，可以看到当前文件被哪些文件引用了。

幻灯片

Obsidian 核心插件里还有一个幻灯片插件，可以在笔记中书写幻灯片。

书写幻灯片的方式和写普通笔记一样，幻灯片的多页用 --- 来分割。比如下面两页 PPT：

• · 第一页只有一个标题

• · 第二页有一个标题和一个列表

# Markdown 实现写 PPT

---

## 常用的 Markdown 解析器

- [markdown-it](https://github.com/markdown-it/markdown-it)

开始演示

有两种方式开始幻灯片演示：

在文件列表中：

• · 右键点击笔记，然后点击开始演示。

命令面板:

• · 按 Ctrl+P（或 macOS 上的 Cmd+P）打开命令面板。

• · 搜索开始 幻灯片 命令。

• · 选中命令后按 Enter 则开始演示当前笔记。

翻页

幻灯片演示过程中翻页有多种方式：

• · 点击右下角的左右箭头，

• · 按键盘上的左右方向键。

• · 按键盘上的上下方向键。

• · 按键盘上的 PgUp 和 PgDn 键，

• · 按下空格键来翻到下一张幻灯片。

要停止演示，按 Escape 键或点击演示文稿右上角的关闭按钮。

备份

如果你还没有备份笔记数据的话，那么事不宜迟，现在就进行备份吧！

为什么要备份笔记数据？

你的笔记默认存储在设备本地，而不是在云端。这确保了笔记数据完全属于你自己， 并让你对数据有控制权。 然而，这种本地存储容易受到现实问题的影响，比如设备损坏或丢失造成笔记数据丢失。 而备份可以让你避免因为这些原因造成的数据丢失，进一步保证了你对笔记数据的控制权。

本地备份

本地备份可以通过社区的插件来完成，设置中浏览社区插件，搜索local backup，点击安装。

然后点击启用，他会弹出最新的更新内容，直接点击确定关闭弹窗即可：

点击设置可以配置备份文件位置、天数、文件名称等内容，这里保持默认即可。

回到应用界面，按快捷键 CTRL + P 打开命令面板，搜索 backup 就可以看到相关备份命令了：

点击 运行本地备份 命令，过一会儿就可以看到在我们设置的备份文件夹里面生成了一个备份文件。

恢复的过程也很简单，将文件解压就可以替换原来的文件就好了。

Git 备份

Git 插件实现了 Git 备份，也是社区中很流行的一个选择。

这个插件会把仓库数据提交到GitHub上以备份你的仓库。 这是一种非常有效的方法，在确保安全性的同时还可以对你的笔记进行版本控制。 但请注意，这种方法会使你的数据存储在 Github 上（配合 Github 插件）。

搜索安装 Git 插件，并启用：

然后点击设置设置你的 Git 仓库即可。

Git 本地备份的原理是在本地 .git 文件夹内记录你所有的操作，包括文件的增删改等。 并且可以很方便的恢复到之前的任意版本。 不过使用上需要了解 Git 的原理和操作方法，对于一般人来说有点儿难度。

同步

Obsidian 多设备同步，也是我们比较常用的一个需求。

比如在学校、公司的电脑写好的东西，同步到家里的电脑，或者手机上。

Obsidian Sync

Obsidian 提供了同步服务 Obsidian Sync ，可以将 Obsidian 的内容同步到你的云端。

4 美元一个月，可以用微信购买，这个是最方便，但是有点费钱的方案。

云服务

如果大家使用的时候 苹果设备，可以直接用 iCloud，这个也比较方便，直接同步文件夹即可， 其他设备也可以用云盘来同步，我就不在这里详细介绍了。

• · Dropbox

• · Google Drive

• · iCloud Drive *

• · OneDrive

• · Syncthing

• · 坚果云

• · 百度网盘

• · 阿里云盘

• · 腾讯微云

• · 夸克网盘

• · 巴别鸟

使用多个同步服务（例如 Obsidian 官方同步和 iCloud 等）可能会导致数据丢失、损坏以及其他问题。 建议大家使用一种同步服务，或者做好备份。

Github

我这里着重讲一下使用 Github 同步。

首先点击设置->第三方插件->关闭安全模式，

点击浏览社区插件：

然后搜索 github ，，找到 Github Sync ，点击安装：

安装成功后，点击启用，然后点击选项，设置你的 Github 地址：

就可以看到界面上有一个同步按钮啦。

Obsidian 的 Git 管理功能比较一般，需要先设置好项目。

笔记重组

合并笔记

有时候我们需要把两篇笔记合并成一篇笔记，但是里面的笔记引用链接需要一个一个处理， 很是麻烦，这时候我们就可以用笔记合并功能。

合并笔记功能会将一篇笔记添加到另一篇笔记中，并删除第一篇笔记。 笔记合并功能会自动更新对第一篇笔记的所有链接，使它们指向合并后的笔记。

Obsidian 支持以下几种合并方式（你可以在操作界面上看到）：

• · Enter：将源笔记添加到目标笔记的 末尾。

• · Shift+Enter：将源笔记添加到目标笔记的 开头。

• · Ctrl+Enter（或 macOS 上的 Cmd+Enter）：新建一篇笔记，使其包含两篇源笔记的内容。

使用笔记合并功能，你可以通过以下几种方式：

在文件列表中：

• · 在文件列表中，右键点击需要合并的笔记。

• · 点击 将该笔记合并到……。

• · 选择需要并入的笔记。

• · 点击 合并。

在命令面板中：

• · 打开命令面板。

• · 输入 将当前笔记合并到其他笔记中。

• · 选择要并入的笔记。

• · 点击 合并。

移动笔记内容

有时候，我们不需要合并整个笔记，而只是希望移动某个章节或者一段内容，我们可以使用笔记内容移动功能。

移动文件内容，同样有邮件和命令两种方式。

在编辑器中：

• · 在编辑视图中，选择要移动的文本。

• · 右键点击所选文本。

• · 点击 将所选内容移动到其他笔记中。

• · 选择要移动到的笔记。

工作区

最后介绍一下工作区。

工作区布局包含了打开的文件、标签页，侧边栏的折叠情况及宽度等信息。

一个工作区代表你一个工作场景，比如阅读、写作、记日记、记工作日志等。

命令面板查找工作区，

点击管理工作区布局，输入你想要保存工作去的名字，点击 Enter。比如我命名为

这样你就可以在你需要的时候加载这个布局。

• · 按下Ctrl+P（或macOS上的Cmd+P）以打开命令面板。

• · 搜索管理工作区布局命令。

• · 选中命令后按Enter。

• · 选择要加载的工作区布局。

常用插件

下面介绍一些常用的社区插件，大家可以去设置->第三方插件搜索安装。

Excalidraw

Obsidian-Excalidraw 插件将 Excalidraw 这一功能丰富的草图工具集成到 Obsidian 中。 您可以在您的库中存储和编辑 Excalidraw 文件，可以将图形嵌入到文档中， 还可以在 Excalidraw 中链接到文档和其他图形。

安装之后你就可以使用它来绘图了：

当然也有深色支持：

这是作者的视频目录，也可以大致看出来 Excalidraw 的绘图能力，

CardNote

此工具可帮助您创建新笔记并将其链接插入画布。让您通过“拖放” 在Obsidian Canvas和obsidian-excalidraw-plugin上快速构建可视化笔记。

Image Captions

可以使用如下格式为图片增加标题：

![[image.jpg|This is a caption|150]]

! [This is a caption|150](image.jpg)

! [[image.jpg|This is a caption with **bold text**]]

! [[image.jpg|This is a caption with [a link to Obsidian](https://)]]

# 文件名

![[image.jpg|%]]
![[image.jpg|\%]]

Auto Link Title

这也是一个很好用的插件，当你粘贴网址的时候，他会自动把网址变成 Markdown 的超链接格式，并且自动获取网址的 Title 作为链接的名称。

比如你自动粘贴baidu的网址，他会变成下面这样：

Colored Text

可以选中文本，右键给文本加颜色。

如果大家喜欢简洁的 Markdown 样式，可以不用这个插件，仅仅使用 加粗、代码等内置的Markdown 语法来记笔记。

如果大家喜欢 WPS 那种直接类富文本编辑的模式可以试一下。

Colored Tags

可以给 Tag 设置颜色。

后台可以这是色板，所以 Tag 会自动生成颜色，但是不支持每个 TAG 单独指定颜色。

Colored Tag Wrangler

可以在设置里面改变 Tag 的颜色（指定颜色），还能和看板插件结合起来使用。

Outliner

深度表格功能的加强：

Better Export PDF

官方 PDF 导出的加强，相比官方的 Export PDF 特性：

• · 🚀支持预览

• · 🎉导出大纲书签

• · 🛩️自定义页边距

• · ✨导出页码

• · 💥支持从元数据中添加PDF元数据

• · 🎇导出当前文件中的内部链接

• · 🎈将多个Markdown文件(文件夹或指定文件)导出到一个PDF文件中

• · 🌸批量导出多个PDF文件

• · 🍬支持将PDF导出到任何大小的页面上，并且可以将所有内容导出到一页上

Pandoc

万能的导出功能，支持多种格式的导出（需要先安装 Pandoc）。

Enhancing Export

基于 Pandoc 的导出。

Recent Flies

最近打开文件面板。

iconize

可以点右键给文件设置单独的 Icon。

Icons

可以在文章内使用各种图标。

Editing Toolbar

编辑器上方显示工具栏，不习惯 Markdown 的朋友可以安装试试。

部分主题可能和该插件不兼容。

Dataview

非常牛的一个插件。

将Obsidian Vault视为可查询的数据库。提供 JavaScript API 和基于管道的查询语言，用于过滤、排序和提取 Markdown 页面中的数据。

比如：显示游戏文件夹中的所有游戏，按评级排序，并包含一些元数据。

\```dataview
table time-played, length, rating
from 'games'
sort rating desc
\```

可能有如下输出：

multi-column markdown

多列显示，可以用这个插件。

--- start-multi-column: ExampleRegion1  
\```column-settings  
number of columns: 2  
largest column: left  
\```

# Text displayed in column 1.
### some title

--- end-column ---

## Text displayed in column 2.

- lists
- list

--- end-multi-column

ExcaliBrain

脑图插件，非常强大。

DataLoom

超级强大的一个插件。将来自不同来源的数据编织在一起并以不同的视图显示它们。

虽然已经不维护了，不过大家依然可以使用。

Projects

可以用数据表的方式管理项目，和 DataLoom 类似。

Vault Explorer

另一个项目内文件的管理方式。

CardBoard

卡片插件，可以和笔记中的任务关联管理。

Kanban

一个看板插件，可以手动添加列，新建任务，无法关联系统内的任务。

Markmind

Obsidian mark mind 是一个思维导图和PDF文件标注工具，支持在手机和电脑全平台上使用，本插件并不是开源的。

3D Graph New

类似我之前写的知识图谱。和 Obsidian 的插件一样，如果要好看一点需要设置很多 Group，

给大家接一个作者视频的效果图吧。

END

好了，虽然 Obsidian 有很强大的功能，但是对于我们来说， 主要还是，多些，多整理 尽量把知识整理好，达到我们最终的目的：

• · 用的时候能找得到。

引用链接

[1] Obsidian 的主页: https:///
[2] 笔记: obsidian://open?vault=主仓库&file=笔记.md
[3] Obsidian标注文档: https://publish./help-zh/%E7%BC%96%E8%BE%91%E4%B8%8E%E6%A0%BC%E5%BC%8F%E5%8C%96/%E6%A0%87%E6%B3%A8