Obsidian 从入门到精通
Obsidian的安装,介绍和高阶使用
1. 背景
Obsidian 既是一个 Markdown 编辑器,也是一个知识库应用。以最基本的方式使用时,你可以编辑和预览 Markdown 文件。但它真正的强大之处在于管理一个紧密互联的知识库
Obsidian是由Shida Li和徐子殷于2019冠状病毒病疫情隔离期间所编写的,两人在滑铁卢大学学习时相识
2020年,发布了第一个版本,obsidian 1.0
- 本地
Markdown文件 - 双向链接[[note]]
- 图谱视图
- 插件化结构
- 本地
远程工作 + 自我学习需求暴涨 → PKM(Personal Knowledge Management)爆发
2020-2021年,Obsidian没有走传统SaaS路线,而是强调本地化和拓展,这一阶段插件生态崛起
2021年-2023年,这个阶段Obsidian开始成为主流的个人知识库管理工具,各类标志性功能的完善和明确的商业模式;还有新功能(Canvas(类似白板),Bases数据库等)
Obsibian CEO下场写Skills,联合Claude Code使用,还有2026年LLM wiki的催化更是引爆了这款软件
哲学理念
心灵对简单观念施加其能力的活动,主要有以下三种:
- 将若干简单观念组合为一个复合观念,所有复杂观念就是这样形成的
- 第二种是将两个观念,无论是简单的还是复杂的,放在一起并排对照观察,而不将它们合二为一,心灵由此获得了所有关于关系的观念
- 第三种是将它们从现实存在中伴随它们的所有其他观念中分离出来:这称为抽象,所有一般性观念就是这样形成的
Obsidian有两种模式,一种是阅览模式,用来专注阅读审查,一种是编辑模式,可以控制是源码模式显示还是实时编辑模式显示
2. 下载安装
- 直接点击windows下载链接
- 打开安装文件,按照指示操作
- 安装完成后,像应用一样打开即可
- 直接点击macOS下载链接
- 在打开的窗口中,将 Obsidian 拖动到”应用程序”文件夹中
- 安装完成后,像App一样打开即可,推出安装文件即可
不同的系统需要不同的安装方法,具体参考官网
- 在 Play 商店上找到 Obsidian。
- 点击安装下载应用
- 安装完成后,按打开其他应用一样的方法打开 Obsidian
- 在 App Store上找到 Obsidian
- 点击获取下载应用
- 安装完成后,按打开其他应用一样的方法打开 Obsidian
3. 快速入门
3.1 创建仓库
Obsidian 将所有笔记保存在仓库中。仓库本质上是本地文件系统中的一个文件夹。你可以将所有笔记保存在一个仓库里,也可以为不同的项目创建不同仓库。
- 本地仓库:将所有笔记保存在本地文件系统中的一个文件夹中
- 远程仓库:将所有笔记保存在远程服务器上,如GitHub、GitLab、坚果云等
第一次打开 Obsidian 时,Obsidian 会询问你是否要创建一个新仓库。此时你有两个选择,你可以创建一个新仓库,或者将现有文件夹作为仓库打开。
- 如图界面创建一个新的仓库:

- 新建仓库
- 仓库名称:给新仓库起一个名字,指定仓库位置
- 点击创建即可
- 将已有文件夹作为仓库打开
当然你可以把直接新建文件夹之后,把文件夹作为仓库打开,同样的操作
文件夹即为仓库就能有很多操作,你可以把文件夹使用git进行追踪利用github进行同步,如果图片多内容多你也可以使用坚果云作为云盘存储同步,安装好之后直接把坚果云中的文件夹作为仓库,每天上传1G,下载3GB的流量应该是足够用

- 在主面板进行创建仓库
在主面板中切换和创建仓库都在左下脚的位置,点击左下角当前仓库的名字,弹出之后选择切换的仓库或者管理仓库即可
- 沙盒仓库
Obsidian 的沙箱仓库是一个让你在不影响现有数据的情况下探索各种功能的特性。该仓库既可以作为学习工具,也可以用于调试问题。它有助于判断问题是由插件、主题还是应用本身引起的。
沙箱仓库在移动设备上不可用
同样在主板页面,切换仓库的旁边,点击帮助图标(?),然后在沙箱仓库旁边选择选择打开即可
沙箱仓库内部有很多简要的使用说明可以查看,包括常见的语法等
要关闭沙箱仓库,请关闭 Obsidian Sandbox 仓库窗口
3.2 创建笔记
Obsidian 中的笔记以纯文本文件的形式存储。这意味着你的数据是持久的,不会被锁定在某种专有格式中。通过用纯文本书写笔记,它们将比任何应用都更长久——甚至包括 Obsidian 本身。
点击左上角新建笔记,创建新的笔记
输入名称”入门markdown语法”作为笔记名称,确认即可
右上角处有三个点(…)的选项中比较重要的是
阅读模式和源模式Obsidian也有所见即所得模式- 阅读模式下无法进行修改
- 源模式开启显示基础的语法,关闭之后显示语法的渲染结果
阅读视图下面,让你能专注于审阅 在编辑模式下,编辑模式定义了 Markdown 的显示方式。你可以选择两种编辑模式之一:实时预览或源码模式
3.3 Obsidian基础语法(兼容Markdown)
下面是Obsidian和Markdown基础语法的了解,相当于用法,还是需要熟能生巧
- 段落
在 Markdown 中创建段落,需使用空行来分隔文本块。每个由空行分隔的文本块都被视为独立的段落
这是一个段落
这是另一个段落- 换行
在 Obsidian 中,默认情况下按一次 Enter 会在笔记中创建新行,但在渲染输出中,这被视为同一段落的延续,这遵循了典型的 Markdown 行为。要在段落内插入换行而不开始新段落
- 在按
Enter之前在行末添加两个空格 - 使用快捷键
Shift+Enter直接插入换行
在设置中–编辑器选项卡–启动严格执行后就必须使用markdown的换行逻辑,而Obsidian默认情况下是关闭严格执行的,在预览模式下按
Enter会直接换行
- 标题
要创建标题,在标题文本前添加最多六个 # 符号。# 符号的数量决定标题的级别
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题- 加粗、斜体、高亮
可以通过在格式符号前添加反斜杠 来强制以纯文本显示
| 样式 | 语法 | 示例 | 输出 |
|---|---|---|---|
| 加粗 | ** ** 或 __ __ |
**加粗文本** |
加粗文本 |
| 斜体 | * * 或 _ _ |
*斜体文本* |
斜体文本 |
| 删除线 | ~~ ~~ |
~~删除线文本~~ |
|
| 高亮 | == == |
==高亮文本== |
==高亮文本== |
| 加粗和嵌套斜体 | ** ** 和 _ _ |
**加粗文本和_嵌套斜体_文本** |
加粗文本和_嵌套斜体_文本 |
| 加粗和斜体 | *** *** 或 ___ ___ |
***加粗和斜体文本*** |
加粗和斜体文本 |
高亮语法是Obsidian增加的,常规markdown和拓展语法不支持
- 内部链接
内部链接相当于整个文件夹内的相互引用或者相互跳转,支持两种方式
- Wiki链接:
[[笔记名称]] - 文件链接:
[笔记名称](@/路径/笔记名称.md)
- 外部链接
如果你想链接到外部 URL,可以用方括号([ ])包围链接文本,然后用圆括号(( ))包围 URL 来创建内联链接。
[Obsidian 帮助](https://help.obsidian.md)也可以通过链接到
Obsidian URI来创建指向其他仓库中文件的外部链接
Obsidian URI 是 Obsidian 支持的自定义 URI 协议,可以让你触发各种操作,例如打开笔记或创建笔记。Obsidian URI 使自动化和跨应用工作流成为可能
- 格式:obsidian://action?param1=value¶m2=value
转义链接中的空格
如果URL 包含空格,必须将空格替换为%20来转义它们
[我的笔记](obsidian://open?vault=MainVault&file=My%20Note.md)或者使用尖括号(< >)包裹URL来转义 [我的笔记](<obsidian://open?vault=MainVault&file=My Note.md>), 用 尖括号< > 包住 URL,可以防止它被当成普通格式或特殊语法解析,从而确保正确显示或识别为链接。
- 图片
markdown标准图片引用方式如下
在Obsidian中,可以在链接中添加|640x480来改变图片的尺寸,其中640是宽,480是高

如果只指定宽度,图片会按原始宽高比缩放
- 引用
可以在文本前添加 > 符号来引用文本
- 列表和任务列表
参考markdown中的有序列表和无序列表
可以在文本前添加 -、* 或 + 来创建无序列表。 创建有序列表,每行以数字开头,后跟 . 或
)符号 比如1.或1),2)
每个列表项以连字符和空格后跟 [ ] 开头
你可以将任何类型的列表——有序、无序或任务列表——嵌套在任何其他类型的列表下
要创建嵌套列表,请缩进一个或多个列表项
可以通过缩进一个或多个列表项来创建嵌套任务列表
分隔线
Obsidian有更多的分隔线格式
***
****
* * *
---
----
- - -
___
____
_ _ _- 代码块和嵌套代码块
- 单个代码或者单行代码
code - 多行代码块
code block,使用请用三个或更多反引号或三个或更多波浪号包围它,并且可以第一组反引号后添加语言代码来为代码块添加语法高亮。
当你需要在一个代码块中包含另一个代码块时(例如,在文档中说明如何使用代码块),你可以为外层代码块使用三个以上的反引号或波浪号。
要嵌套代码块,外层块使用四个或更多反引号(或波浪号),而内层块使用三个:
以下是如何创建代码块:
```js
console.log("Hello world")
```- 脚注
可以使用语法为笔记添加脚注1
这是一个简单的脚注[^1]。
[^1]: 这是引用的文本。
[^2]: 在每个新行的开头添加 2 个空格。
这样你就可以编写跨多行的脚注。
[^note]: 命名脚注仍然显示为数字,但可以更容易地识别和链接引用。- 注释
注释类似Latex语法,使用%%包裹文本来添加注释。注释仅在编辑模式中可见
这是一个 %%行内%% 注释。
%%
这是一个块注释。
块注释可以跨多行。
%%- 转义
在某些情况下,你可能需要在 Markdown 中显示特殊字符,如 *、_ 或 #,而不触发它们的格式化效果。要按字面意思显示这些字符,请在它们前面放置反斜杠()。
3.4 Obsidian拓展语法
Obsidian也有高级格式的语法,其实更像是复杂结构的语法,和markdown类似,包含表格,图表,流程图和数学公式等
- 表格
你可以使用竖线(|)和短横线(-)来创建表格。竖线用于分隔列,短横线用于定义列标题
| 名字 | 姓氏 |
| ---- | ---- |
| 麦克斯 | 普朗克 |
| 玛丽 | 居里 |这是最简单的表格,Obsidian还支持鼠标导入表格,并且带有对齐,增删行列;同样的表格中的内容也可以增加链接,放置图片,设定格式等
- 图表
使用Mermaid语法在笔记中添加图表和流程图,Mermaid 支持多种图表,如流程图、时序图和时间线等。
Mermaid 是一个基于 JavaScript 的图表和流程图生成器,它使用简单的文本语法来描述图表和流程图,然后使用 JavaScript 将其渲染为 HTML 和 CSS。Mermaid 支持多种图表类型,包括流程图、时序图、甘特图、类图、状态图、饼图、折线图等。
可以使用在线Mermaid编辑器来进行搭建
```mermaid
sequenceDiagram
Alice->>+John: 你好 John,你好吗?
Alice->>+John: John,你能听到我吗?
John-->>-Alice: 嗨 Alice,我能听到你!
John-->>-Alice: 我感觉很好!
```在图表中添加链接
你可以通过将节点声明为 internal-link类型 来在图表中创建内部链接
```mermaid
graph TD
生物学 --> 化学
class 生物学,化学 internal-link;
```- 数学公式
使用LaTeX语法在笔记中添加数学公式,Obsidian 支持使用 LaTeX 语法来编写数学公式。在数学公式中,你可以使用美元符号(\()来包裹公式,例如 `\)E=mc^2$`。
这是一个简单的数学公式:$E=mc^2$。要在笔记中添加 MathJax 公式,请用双美元符号($$)将其括起来。
3.5 Obsidian 支持的markdown拓展
Obsidian 致力于在不破坏任何现有格式的前提下实现最大的功能,使用了多种 Markdown 风格的组合。Obsidian 支持 CommonMark、GitHub Flavored Markdown 以及 LaTeX
| 语法 | 描述 |
|---|---|
[[Link]] |
内部链接 |
![[Link]] |
插入文件在笔记中直接显示另一篇笔记的内容或图片,而不是仅仅放一个链接 |
![[Link#^id]] |
块引用主要是文件中的标题,定义的块等引用 |
^id |
定义块,给想引用的内容打上标签 |
[^id] |
脚注 |
%%Text%% |
注释 |
~~Text~~ |
删除线 |
==Text== |
高亮 |
``` |
代码块 |
- [ ] |
未完成任务 |
- [x] |
已完成任务 |
> [!note] |
标注 |
(见链接) |
表格 |
3.6 附件
你可以把Obsidian仓库理解为文件夹,可以向仓库中导入任何文件格式作为附件,如图片,音频文件或者PDF文件.这一类文件在Obsidian中被称为附件,附件可以插入到笔记中,也可以直接在Obsidian中打开查看
添加附件方式:
- 复制粘贴附件,Obsidian 会在默认的附件储存位置保存所粘贴的文件,并将其嵌入到笔记中。
- 拖放附件:Obsidian 会将该文件复制到默认的附件储存位置,并将其嵌入到笔记中。
- 将附件下载到仓库
更改默认附件存储位置
你可以在设置 → 文件与链接 → 附件默认存放位置中更改默认的附件储存位置。

- 仓库的根目录 将附件保存到仓库的根目录
- 指定的附件文件夹 将附件保存到指定的文件夹中
- 当前文件所在的文件夹 将附件保存到添加附件的笔记所在的文件夹中
- 当前文件所在文件夹下指定的子文件夹中 将附件保存到添加附件笔记所在文件夹里的一个指定子文件夹里。如果该文件夹不存在,Obsidian 将在保存附件时自动创建它
首先学会自定义文件夹,才能进行真正的文件管理
3.7 标注
使用标注可以在不打乱笔记行文的情况下添加额外内容
- 基础
要创建标注,将 [!info] 添加到引用块的第一行即可。其中 info 是 类型标识符。类型标识符决定了标注的外观。
> [!info] 这是标注的标题
> 这是一个标注块。
> 它支持 **Markdown**、[[内部链接|内部链接]] 和 [[插入文件|嵌入]]!
> ![[Engelbart.jpg]]可以使用
插入标注的命令来插入默认的[!note]标注,光标会自动定位到标注名称的字段

> [!NOTE] Title
> Contents- 标注的标题是其类型标识符。你可以在类型标识符后添加文本来更改它
- 甚至可以省略内容,创建仅带标题的标注
你可以通过在类型标识符后添加加号(+)或减号(-)来使标注可折叠. 加号表示标注默认展开,减号表示标注收起
> [!faq]- 标注可以折叠吗?
> 可以!在可折叠标注中,当标注收起时,内容会被隐藏。- 嵌套标注
标柱也可以进行嵌套
> [!question] 标注可以嵌套吗?
> > [!todo] 可以。
> > > [!example] 你甚至可以使用多层嵌套。- 自定义标注
CSS 代码片段 和 第三方插件 可以定义自定义标注,甚至覆盖默认配置。

在设置–外观–CSS代码片段,找到CSS的设置,点击fold文件夹,跳转到文件夹中,创建新的CSS文件,名字例如叫custom-callout.css,刷新之后就能看到新的自定义的标注样式了
CSS文件内容如下:
.callout[data-callout="custom-question-type"] {
--callout-color: 0, 0, 0;
--callout-icon: lucide-alert-circle;
}- data-callout 属性的值是你想要使用的类型标识符
- –callout-color 使用三个数字(0-255)定义背景颜色的红色、绿色和蓝色分量
- –callout-icon 是类型的图标,其可以是 lucide.dev 的图标 ID,或者一个 SVG 图标
- 支持的类型
Obsidian 内置了多种标注类型。每种类型都带有不同的背景颜色和图标。
除非使用自定义标注,否则任何不支持的类型都会默认为 note 类型。类型标识符不区分大小写,但部分类型有别名
- Note
- Abstract(summary, tldr)
- Info
- Todo
- Tip
- Success(check,done)
- Question
- Warning
- Failure(fail,error)
- Danger
- Bug
- Example
- Quote(cite)
3.8 折叠和多光标模式
折叠 你可以通过将鼠标悬停在要折叠的部分上,然后点击左侧的箭头来折叠标题和缩进列表。已折叠的部分会始终显示箭头,无论鼠标是否悬停在上面。
折叠功能默认是开启的。要关闭折叠功能,请打开设置 → 编辑器,然后根据需要关闭折叠缩进或折叠标题。
多光标模式
Obsidian 允许你使用多光标模式同时在多个位置编辑文本。你可以按住 Alt(macOS 上为 Option)并选择笔记中的另一个位置来添加额外的光标。
适用于英文模式,中文输入法下面不能同时编写
要移除选区及所有额外的光标,只需在笔记中任意位置点击,无需按住任何键。你也可以按 Escape 来移除选区。
3.9 网页和HTML嵌入
- 标准模式
Obsidian支持链接的嵌入,所以之前的![]()方式也是可以直接嵌入Youtube视频,Twitter等,Obsidian会把嵌入的链接呈现预览模式


- 使用
iframe这种格式进行嵌入
要嵌入一个网页,只需在你的笔记中添加以下内容,并用你想要嵌入的网页 URL 替换”在这里插入你的URL”
<iframe src="在这里插入你的URL"></iframe>有些网站不允许嵌入。有些网站则可能会提供专门用于嵌入的 URL。如果网站不支持嵌入,请尝试搜索”网站名 iframe”以查找解决方法。例如,“youtube embed iframe”。
- iframe 更像是模版,是 HTML 里的一个标签,用来在当前网页中嵌入另一个网页或内容
- HTML内容
Obsidian 支持 HTML,让你可以按照自己想要的方式显示笔记,甚至可以嵌入网页。在笔记中允许使用 HTML 会带来风险。为了防止恶意代码造成危害,Obsidian 会对笔记中的 HTML 进行净化处理。
Obsidian 不会在 HTML 元素内渲染 Markdown 语法。这是出于性能优化以及在管理大型文档时降低解析器复杂度的考虑而做出的设计选择
<div>
This **will not** be bold and this `will not` be code.
</div>HTML 块必须是完整的,且内部不能包含空行。空行会打断 HTML 块
- 注释
- 下划线
<u>Example<\u> - Span/Div Span 和 div 标签可以用来将 CSS 代码片段中的自定义类或自定义样式应用到选定的文本区域。
- 删除线
3.10 属性
在 Obsidian 里,“属性(Properties)”其实就是给笔记加结构化信息(元数据),让你的笔记从“纯文本”升级为“可管理的数据”。
属性 = 给笔记打标签 + 加字段 + 可被系统读取
- 分类筛选
- 构建数据库
- 统一模板
- 自动化工作流程
- 给笔记添加属性
当写好一篇文章或者准备写时,可以通过多种方法添加属性(yaml)
- 使用命令(command + p),添加笔记属性
- 使用
Cmd/Ctrl+;快捷键等 - 使用
...菜单,打开之后选择添加笔记属性
添加属性之后,文件顶部会出现一行,包含两个输入项目:属性的名称和属性的值

- 属性类型
除了名称和值之外,属性还有一个类型。属性的类型决定了它可以存储什么样的值以及 Obsidian 如何处理它们。要更改属性的类型,请点击属性名称旁边的类型图标并选择不同的选项。
| 类型 | 能存什么 | 用途 |
|---|---|---|
| 文本 | 任意文字 | 描述 |
| 列表 | 多个值 | 多标签/多作者 |
| 数字 | 数值 | 统计 |
| 复选框 | true/false | 状态 |
| 日期 | 日期 | 时间轴 |
| 日期&时间 | 精确时间 | 日志 |
| 标签 | 标签系统 | 分类 |
- 搜索属性
属性有自己的搜索语法,可与其他搜索词和运算符一起
搜索是一个核心插件,帮助你通过搜索词和运算符在 Obsidian 仓库中查找数据,从而缩小结果范围
默认情况下,可以在左侧边栏中搜索,使用 Command-FCommand-F是用来查看文章内容的,而Command-shift-FCommand-shift-F用来搜索
- 搜索选中文本:如果你在编辑器中选中了文本,然后通过快捷键打开搜索,搜索会显示所选文本的搜索结果
- 搜索最近的搜索词:在搜索词为空时打开搜索,会列出最近使用过的搜索词。点击任意一个即可再次使用该搜索词
搜索词是你在搜索框中输入的单词或短语,添加运算符可以实现更精确的搜索
- 可使用转义
- 可使用逻辑运算(OR, AND, NOT等)组词
- 可使用运算符

| 分类 | 运算符 | 描述 | 示例 | 备注 |
|---|---|---|---|---|
| 文件 | file: |
在文件名中查找文本 | file:.jpg |
|
| 文件 | path: |
在文件路径中查找文本 | path:"Daily notes/2022-07" |
|
| 内容 | content: |
在文件内容中查找文本 | content:"happy cat" |
|
| 大小写 | match-case: |
区分大小写匹配 | match-case:HappyCat |
|
| 大小写 | ignore-case: |
不区分大小写匹配 | ignore-case:ikea |
|
| 标签 | tag: |
在文件中查找标签 | tag:#work |
不匹配 #myjob/work;忽略代码块 |
| 行 | line: |
查找至少包含一行匹配内容的文件 | line:(mix flour) |
|
| 行(否定) | -line: |
查找不包含匹配行的文件 | -line:(mix flour) |
|
| 块 | block: |
在同一块中查找匹配项 | block:(dog cat) |
解析 Markdown,可能较慢 |
| 节 | section: |
在同一节(标题之间)中查找匹配 | section:(dog cat) |
|
| 任务 | task: |
在任务中查找匹配项 | task:call |
|
| 未完成任务 | task-todo: |
查找未完成任务 | task-todo:call |
|
| 已完成任务 | task-done: |
查找已完成任务 | task-done:call |
- 模板
当你将模板插入活动笔记时,模板中的所有属性都将被添加到笔记中。Obsidian 还会将笔记中已有的属性与模板中的属性进行合并。
可以在所有属性视图中右键点击属性来重命名它
- 属性格式
属性以 YAML 格式存储在文件顶部。YAML 是一种流行的格式,人类和计算机都可以轻松阅读
属性名称与其值之间用冒号加空格分隔
---
name: value
---每个名称–值对的顺序是无所谓的,但是每个名称在笔记中必须是唯一的. 但是属性每一个都只有一种,防止冲突
- 文本
-
文本属性包含单行文本。Markdown 格式不会在文本属性中渲染。在文本属性中使用
#号不会创建标签
---
title: A New Hope
link: "[[Episode IV]]"
url: https://www.example.com
---列表
列表属性包含多个值。列表中的每个值单独占一行,前面有一个短横线(-)和一个空格
相对于源码来说,列表值可以包含文本、数字和内部链接。在列表属性中使用内部链接时,请用引号括起来。如果是obsidian直接写,obsidian会自动处理格式,但是操作点击的时候会比较麻烦
---
cast:
- Mark Hamill
- Harrison Ford
- Carrie Fisher
links:
- "[[Link]]"
- "[[Link2]]"
---复选框
复选框属性的值为 true 或 false。在实时预览中,它会显示为一个复选框。
---
favorite: true
reply: false
last: # 不确定的值;通常被视为 false标签
标签属性是一种特殊的属性类型,专用于 tags 属性。此属性类型不能分配给其他属性
标签属性的格式为列表,每个标签单独占一行,前面有一个短横线(-)和一个空格。
要使用 搜索 插件查找笔记,可以在搜索词中使用 tag 搜索符,例如 tag:#会议。嵌套标签定义了标签层次结构,使查找和筛选相关标签更加容易。
3.11 标签
标签是 Obsidian 中最强大的功能之一,它们允许你将笔记组织成层次结构,并使用搜索来查找相关内容。
可以放在元属性的开头,也可以放在正文中
标签中使用一下字符
- 字母
- 数字
- 下划线 (_)
- 连字符 (-)
- 正斜杠 (/)
标签必须至少包含一个非数字字符; 标签不区分大小写。例如, #tag 和 #Tag 将被视为相同标签。
4. 用户界面
前期学习了Obsidian如何创建仓库,如何创建笔记,Obsidian入门语法,拓展语法等,进入后Obsidian界面之后,就可以熟悉界面,提升笔记效率
打开软件之后,目之所及的区域都可以被叫做工作区
4.1 标签页

在Obsidian中,每打开一篇笔记就像浏览器打开一个网页一样,标签页的工作方式和网页浏览器非常类似
在 Obsidian 中打开任意数量的标签页, 还可以排列标签页,创建自定义布局,这些布局会一直保留,直到下次打开应用程序
- 打开新标签页
在应用程序窗口顶部,最右边的标签页旁边,点击新标签页(+)即可,当然也可以使用快捷键
- Windows 和 Linux:
Ctrl+t - macOS:
Cmd+t
- 打开链接
Obsidian中内部链接的特性,可以直接点击链接打开新的标签页.默认情况下,点击链接会在当前标签页跳转到链接笔记,要在新标签页中打开链接,请按下Ctrl(或 macOS 上的Cmd)再点击链接
标签还有一个标签组的概念,更像是把标签页分屏操作查看,每个标签组都能够独立操作
当有内部链接的时候,选择链接,然后右键选择新的标签组打开即可
- 组织标页和窗口
Obsidian 中,每个标签页都属于一个 标签组 。你可以通过拖放标签页来重新排列它们在标签组内的位置,或将它们移动到另一个标签组中,或者创建一个新的标签组。
在桌面端,你可以将标签拖出它们的窗口,以在单独的窗口中打开它们

在左侧和右侧的栏目中也能把标签页拖入,但是左右侧比较特殊不显示标签的标题,只是显示图标,同样可以编辑查看
右键单击一个标签页,在菜单中点击左右拆分或上下拆分以创建一个包含该标签页的新标签组
- 调整标签组大小
要调整标签组的大小,请将光标悬停在标签组的边缘上。当可以拖动调整大小时,边缘会被高亮显示,光标也会变为扩展符号.类似地,你也可以调整侧边栏的大小,以为中间的标签组腾出更多空间。
要在主编辑器中固定一个标签页,请右键单击标签页,选择锁定。锁定标签页中的链接总是会在新标签页中打开。
要在主编辑器中取消锁定一个标签页,请右键单击该标签页,选择取消锁定
- 堆叠标签页
可以在某个标签组中堆叠标签页,这样这个标签组的标签就会换一种显示效果. 要堆叠标签页,请选择标签组右上角的向下箭头,然后选择堆叠标签页

- 关联
关联视图 是让某个视图与特定标签页相关联。当该标签页打开不同的笔记时,视图也会发生相应变化。
通俗一点来说就是当你切换标签页的时候,不同标签页对应的关联内容也会自动更新对应,通常是右侧视图栏包括
- 标签页内的大纲
- 反向链接
- 局部关系图
4.2 侧边栏
Obsidian 有两个侧边栏:左侧边栏和右侧边栏。侧边栏中包含由插件创建的标签页,例如反向链接、出链和文件列表。

在桌面端,你还可以将笔记拖入侧边栏,使其与主编辑器并排显示。
在桌面和较大的平板设备上,左侧边栏包含有功能区,但是在移动设备上,侧边栏默认处于收起状态
- 标签页
在Obsidian中,大纲(outline), 反向链接(Blacklinks), 局部关系图(Outliner)等算是侧边栏标签页,算是面板页签
打开或重新打开标签页
启用插件:许多插件在启用时会自动创建侧边栏标签页。前往设置 → 社区插件市场(或核心插件)并启用你需要的插件,有些插件打开之后会在侧栏上出现图标,点击类似标签页 提供信息
执行命令:使用命令面板搜索可打开特定标签页的命令。例如,搜索”反向链接”或”出链”即可打开相应的标签页
拖动笔记(仅限桌面端):在桌面端,你可以从文件列表或编辑器标签页中将笔记拖入侧边栏来打开它
重新排列/锁定标签页
你可以通过拖放标签页图标来重新排列同一标签页组内的标签页顺序
可以在侧边栏中锁定标签页,以控制当你与应用的其他部分交互时标签页如何更新
- 标签页组
侧边栏的标签也是能够分组,类似分屏的,然后把布局保存即可
注意是把图标往上下移动,而不是左右,左右时更改位置,上下才是分组

4.3 功能区
功能区是Obsidian用于放置常用命令和部分高级功能插件的区域,相当于快捷键,位于最左侧和左下方

- 操作
功能区中的每个操作都由一个图标表示。悬停在这些图标上会显示提示信息,点击则会激活对应的操作
在桌面端可以按照下面方式自定义功能区:
- 通过拖放图标来重新排列功能区操作的顺序
- 要隐藏特定操作,右键点击功能区中的空白区域,取消勾选你想隐藏的操作
- 隐藏/打开功能区
功能区默认是开启的,可通过方式隐藏功能区:
- 右键点击功能区并选择隐藏功能区
- 打开设置 → 外观,向下滚动到高级,禁用显示功能区

4.4 快捷键
快捷键是 Obsidian 命令的可自定义键盘快捷方式。你可以为任何命令分配键盘组合,例如打开文件、插入模板或切换插件
所有操作都可以命令化
设置快捷键
- 打开设置 → 快捷键
- 在列表中找到相应命令,或使用搜索筛选
- 选择命令旁边的加号(+)图标
- 按下你想要使用的键盘组合
- 选择保存以确认
你可以为单个命令分配多个快捷键组合,只需在设置第一个快捷键后再次选择加号(+)图标即可
| 功能 | 推荐 |
|---|---|
| 命令面板 | Ctrl+P |
| 快速切换笔记 | Ctrl+O |
| 搜索全文 | Ctrl+Shift+F |
| 分屏右侧 | Alt+→ |
| 关闭标签页 | Ctrl+W |
| 今日笔记 | Alt+D |
| 模板插入 | Alt+T |
4.5 设置
设置允许你自定义 Obsidian 的使用体验, 可以配置常规选项、编辑器偏好、外观、快捷键,并管理核心插件和第三方插件

桌面端的Obsidian,可以在左侧边栏下方,选择设置,也可以使用默认快捷键Cmd + ,,直接打开
设置按照功能分类,可以分为常规选项(常规,编辑器,文件与链接,外观和快捷键),核心内置的插件(安装过程中自带的)和第三方插件
- 常规
关于
- 版本: 检查更新
- 自动更新: 启用或禁用自动更新
- 语言: 软件打开的语言
账户
- 登录: 登录或注册 Obsidian Cloud 账户
- 商用许可证: 如果你在工作中使用 Obsidian,选择激活输入商用许可证密钥,或选择购买购买许可证。选择了解更多获取有关商用许可的信息
高级
- 应用启动缓慢时进行通知
- 命令行界面: 用来Obsidian CLI交互 (Obsidian CLI必须打开此选项,打开之后路径会注册)
- 编辑器
编辑器页面包含查看和编辑笔记的相关设置
常规
- 始终聚焦新标签页: 当你在新标签页打开链接,立即切换至新标签页
- 新标签页的默认视图: 新 Markdown 文件标签页打开时的默认视图。可选择阅读视图或编辑视图
- 默认编辑模式: 在编辑视图下,新标签页默认采用的编辑模式。可选择实时预览或源码模式
- 视图状态: 在状态栏中显示编辑模式的切换按钮,就是显示用处不大
外观
- 限制行宽: 开启后将限制每行显示的字数,使屏幕显示的内容减少,但使较长的段落更具可读性。
- 严格换行: Markdown 规范在阅读视图中会忽略单个换行,就是使用单个
Enter换行不起效,必须后续加两个空格 - 笔记属性: 笔记顶部显示属性,选择YAML格式,就是源代码显示
- 折叠标题: 选择标题旁边的收起图标,折叠标题下的所有内容
- 折叠缩进: 选择收起图标,折叠缩进内容(如列表)的一部分
- 行号: 左侧显示行号(更像是段号)
- 缩进参考线: 在缩进的行之间显示参考线
- 从右到左 (RTL): 将文字的默认文本方向设置为从右到左
行为
- 拼写检查: 打开拼写检查器。选择齿轮图标可从自定义词典中移除已保存的条目
- 拼写检查语言: 将自动选择使用的语言
- 自动补全英文标点符号
- 自动补全 Markdown 语法
- 智能列表: 开启后 Obsidian 将根据换行和缩进情况自动调整列表符号
- 使用制表符: 使用 Tab 键进行缩进时插入制表符。关闭此选项则使用 4 个空格进行缩进
- 制表符宽度: 设置制表符等同的空格数(2-8空格)
- 文件与链接
文件与链接页面包含文件管理、链接和仓库行为的相关设置
新建笔记的存放位置
指定新建笔记的存放路径。
- 仓库的根目录 — 笔记创建在仓库的根目录中
- 当前文件所在的文件夹 — 笔记创建在当前活动笔记所在的文件夹中
- 指定的附件文件夹 — 笔记创建在你选择的特定文件夹中
附件默认存放路径
新添加的附件的存放位置。选项包括:
- 仓库的根目录 — 附件放置在仓库的根目录中
- 指定的附件文件夹 — 附件放置在你选择的特定文件夹中
- 当前文件所在的文件夹 — 附件放置在当前活动笔记所在的文件夹中
- 当前文件所在文件夹下指定的子文件夹 — 附件放置在当前笔记文件夹内的子文件夹中
最好是在子文件下面自定义一个文件夹用来放置附件,但是不同功能的笔记有不同的设计,按需设计即可
- 链接
内部链接类型
自动生成内部链接时插入的链接格式。选项包括
- 尽可能简短的形式 — 使用链接文件的最短唯一路径
- 基于当前笔记的相对路径 — 使用相对于当前文件的路径
- 基于仓库根目录的绝对路径 — 使用从仓库根目录开始的完整路径
- 始终更新内部链接
- 启用后,Obsidian 会在你重命名文件时自动更新内部链接。关闭此选项则会在重命名后提示是否更新链接
- 使用Wiki链接
- 自动为 [[链接]] 和 ![[图片]] 生成 Wiki 链接而非 Markdown 链接和图片。禁用此选项则生成 Markdown 链接
- 显示所有类型文件
- 在文件列表和快速切换中显示所有类型的文件,即使是那些目前 Obsidian 不支持的类型。开启此选项后可以对不支持的文件进行链接
- 回收站
- 确认文件删除
- 删除文件之前进行确认,防止误删
已删除文件
要如何处理已删除的文件?选项包括:
- 移至系统回收站– 文件被移到操作系统的回收站
- 移至Obsidian回收站– 文件被移到仓库中的
.trash文件夹 - 永久删除– 文件被永久删除,无法恢复
删除文件时询问附件是否删除
- 高级
忽略文件
忽略的文件将在搜索、关系图谱和潜在链接(反向链接和出链)中隐藏,并且在快速切换和链接建议中不太显眼。选择管理来配置忽略的文件。
让某些文件或文件夹“不参与知识库分析”,从而减少干扰、提升搜索与关系图谱质量
典型用途
- 忽略附件目录
- 忽略AI自动生成目录
URI回调
在 Obsidian 中,URI 回调本质上就是:链接协议
在 Obsidian 中,URI 回调本质上就是:obsidian://该协议可以在浏览器,shell,python调用,AI Agent调用等方式打开Obsidian制定的文件库
4.6 外观
- 常规
基础颜色
Obsidian 自带两种基础颜色,分别是浅色和深色。默认情况下,基础颜色会根据你的操作系统进行自适应设置。你可以通过前往设置 → 外观来进行更改
- 跟随系统 — 匹配操作系统的浅色或深色模式
- 浅色 — 使用浅色模式
- 深色 — 使用深色模式
主题色
为 Obsidian 选择一个主题色。选择颜色选择器或重置图标进行自定义,使用RGB进行调色
主题
管理已安装的主题并浏览社区主题。选择管理查看和安装主题。下拉菜单显示当前激活的主题。文件夹图标可打开设置文件夹中的主题文件夹。

- 界面
- 页面标题: 将文件名作为可编辑的标题在文件内容中显示
- 显示标签页标题栏:在每个标签页上方显示标题栏
- 显示功能区
- 功能区: 设置哪些命令显示在功能区
- 字体
Obsidian内置了很多字体,自行选择即可
- 界面字体: 设置 Obsidian 界面字体。选择管理来选择自定义字体或输入字体名称
- 正文字体: 设置编辑视图和阅读视图中笔记正文的字体。选择管理来选择自定义字体或输入字体名称。
- 代码字体: 设置代码块、元数据源码等文本的字体。选择管理来选择自定义字体或输入字体名称
- 字体大小: 调整编辑视图及预览视图中的字体大小(单位为像素)。使用滑块进行调整
- 快速调整字体大小: 使用Ctrl+滚轮Ctrl+滚轮
- 高级
- 缩放比例:控制应用程序的整体缩放比例。使用滑块进行调整,相当于调整软件显示的大小
- 原生菜单: Obsidian 中所有的菜单都会匹配操作系统,不会跟随主题样式
- 窗口边框样式: 更改 Obsidian 窗口边框的样式。该设置重启应用后生效
- Obsidian 风格 — 使用 Obsidian 的自定义窗口边框
- 原生边框 — 使用操作系统的默认窗口边框
- 隐藏边框 — 完全隐藏标题栏
- 半透明效果: 启半透明效果以增强沉浸感(深色模式下开启效果更佳)。Linux 不支持此效果。
- 硬件加速: 开启硬件加速,即使用 GPU 让 Obsidian 运行更流畅。如果关闭此选项,应用性能可能会严重下降,但可以解决一些罕见问题
5. 链接笔记与文件
Obsidian最强大的功能就是笔记链接网络,内部链接从笔记中链接到其他笔记,附件和文件,然后进行可视化

当你重命名文件时,Obsidian可以自动更新仓库中的内部链接,如果你想每次都弹窗确认,可以在设置–文件与链接–始终更新内部链接
- 内部链接支持的格式
Obsidian支持以下链接格式:
- Wiki 链接:
[[Three laws of motion]]或[[Three laws of motion.md]] - Markdown:
[Three laws of motion](Three%20laws%20of%20motion)或[Three laws of motion](Three%20laws%20of%20motion.md)
上面的方式是等价的,Wiki写法更加的紧凑,markdown比较通用
包含以下字符的字符串可能无法作为链接使用:# | ^ : %% [[ ]]
- 链接到文件
要在编辑模式下创建链接,可以使用以下任一方式:
- 在编辑器中输入
[[,然后选择要链接的文件 - 在编辑器中选中文件,输入
[[, 会把选中的文本作为链接的形式,双击就能形成以当前文本为标题的文档进行编写 - 打开控制面板.然后选择插入内部链接
在内部链接前加上感叹号(!)可以嵌入链接的内容。
- 链接到笔记中的标题
锚点链接:链接到笔记中的特定标题
链接到同一笔记中的标题
要链接到同一笔记中的标题,输入 [[# 即可获取当前笔记中可链接的标题列表。
链接到其他笔记中的标题
要链接到其他笔记中的标题,在链接目标末尾添加井号(#),后接标题文本,例如[[关于 Obsidian#链接是一等公民]]
链接到子标题
你可以为每个子标题添加多个井号 [[帮助与支持#Questions and advice#Report bugs and request features]]
- 链接到笔记中的块
块是笔记中的一个文本单元,例如段落、引用块或列表项
可以通过在链接目标末尾添加 #^ 和一个唯一的块标识符来链接到一个块,当你在一篇a.md某一段落后加了^test,然后在b.md中输入[[a.md#^test]]就可以链接到a.md中^test标识的段落
必须在行末放置一个空格,后接脱字符^和块标识符(标识符可以自己写,也可以随机生成)
对于结构化块(列表、引用、标注、表格),块标识符应在单独一行,前后各有一个空行:
> The quick purple gem dashes through the paragraph with blazing speed. Pen in hand and a paperclip in the other, Gemmy works toward her goal of making the world of note-taking a happier place.
^37066f
This is the tale of Gemmy, the Unhelpful assistant. 对于列表的特定行,块标识符可以直接放在列表项上:
- Gemmy
$$Paperclip / Pen$$
^37006f
- Unhelpful assistant在整个仓库中搜索块
可以使用 [[^^block]] 语法在整个仓库中搜索要链接的块。但是,与标题链接相比,更多内容会被视为块,因此列表会更长。
块标识符只能包含拉丁字母、数字和连字符
- 更改链接的显示文本
默认情况下,Obsidian会按照原样显示链接
[[Example]]显示为Example[[Example#Details]]显示为Example#Details
使用竖线(|)来更改显示文本
[[Example|自定义名称]]显示为自定义名称[[Example#Details|章节名称]]显示为章节名称
使用 [显示文本](链接 URL) 来自定义链接的显示方式
[Example](Example)显示为Example[Example](Example#Details)显示为Example#Details
- 别名
如果你想用不同的名称来引用一个文件,可以为笔记添加别名。别名是笔记的替代名称
别名可以用于缩写、昵称,或者用不同语言引用笔记等场景
为笔记添加别名
要为笔记添加别名,请在笔记的属性中添加 aliases 属性。别名在 YAML 中应始终以列表格式书写
---
aliases:
- Doggo
- Woofer
- Yapper
---
# Dog在别的文本中引用别名,也是可以链接的
- 插入文件
在 Obsidian 中,你可以通过在笔记内插入别的文件,从而实现复用仓库内的内容
要在当前笔记中插入文件,在内部链接前加上感叹号(!)即可。目前,Obsidian 仅支持对特定文件格式的插入
支持的文件类型 - Markdown:.md - 数据库:.base JSON Canvas:.canvas(了解更多) - 图片:.avif、.bmp、.gif、.jpeg、.jpg、.png、.svg、.webp - 音频:.flac、.m4a、.mp3、.ogg、.wav、.webm、.3gp - 视频:.mkv、.mov、.mp4、.ogv、.webm - PDF:.pdf
在当前笔记中插入另一篇笔记
# 要在当前笔记中插入另一篇笔记,你只需要在链接这篇笔记的语法前加一个感叹号
![[需要插入的笔记标题]]
# 插入特定笔记中的标题和块
![[内部链接#^b15695]]在当前笔记中插入照片
# 在当前笔记中插入照片,你只需要在链接这张照片的语法前加一个感叹号
![[需要插入的照片路径]]
# 图片比例
# 添加|100x245来更改图片显示的大小,其中100是宽度,245是高度
![[Engelbart.jpg|100]]插入音频文件
![[Excerpt from Mother of All Demos (1968).ogg]]
笔记中插入PDF文件
![[Document.pdf]]
# 插入特定页面
![[Document.pdf#page=3]]笔记中插入列表
- 列表项 1
- 列表项 2
^my-list-id
# 插入
![[My note#^my-list-id]]插入白板
![[My canvas.canvas]]
6. 插件
插件分为Obsidian自带的核心插件和第三方插件,核心插件由 Obsidian 团队官方开发和维护,并内置于应用中。第三方插件则由社区开发者开发,需要手动安装。
部分核心插件默认处于禁用状态,可以在设置—>核心插件中启用
6.1 Markdown格式转换器
Markdown 格式转换器是一个核心插件,可以将其他应用中的 Markdown 转换为 Obsidian 格式。它还可以将某些属性转换为新的必需格式。
markdown转换器插件 相当于一个命令,会转换你当前仓库全部文件,确保文件备份好之后进行转换
markdown格式转换器,默认是关闭的,要在设置里面—->核心插件中开启,开启之后功能区右侧就会有(1001的图标)或者在命名面板中,输入``markdown格式转换器
- 启动插件
- 启用想要转换的格式
- 点击开始转换

支持的格式
- Roam Research
- Bear
- Zettelkasten
| 维度 | Bear | Roam Research | Zettelkasten |
|---|---|---|---|
| 类型 | 笔记软件 | 网络化笔记软件 | 知识管理方法论 |
| 核心理念 | 优雅写作 | 思维网络连接 | 长期知识积累 |
| 核心结构 | 文档(Note) | Block(块) | 原子化卡片(Atomic Notes) |
| 最小单位 | 一篇笔记 | 每一行 Block | 一个思想 |
| 组织方式 | 标签 + 文件 | 双向链接 + Block | 概念连接 |
| 是否依赖固定语法 | 是(Markdown 扩展) | 是(Outliner + 双链) | 否(方法论) |
| 双向链接 | 基础支持 | 核心功能 | 依赖具体软件 |
| Block 引用 | 很弱 | 非常强 | 取决于软件 |
| 图谱视图 | 无 | 有 | 取决于软件 |
| 标签系统 | 非常强 | 一般 | 可选 |
| Daily Notes | 一般 | 非常强 | 常结合使用 |
| Markdown 支持 | 强 | 一般 | 取决软件 |
| 长期知识沉淀 | 中等 | 强 | 极强 |
| 假说关联能力 | 一般 | 很强 | 非常强 |
| AI/自动化扩展 | 较弱 | 一般 | 常结合 Obsidian |
| 本地文件支持 | 一般 | 较弱 | 取决软件 |
| 插件生态 | 小 | 小 | 无(依赖平台) |
| 离线能力 | 好 | 一般 | 取决软件 |
6.2 书签
书签是一个核心插件,可以让你快速访问经常使用的项目,就像”快捷方式”一样。
以下内容都是可以添加书签的
- 文件
- 文件夹
- 图谱
- 搜索结果
- 小标题
- 块
- 链接
将以上项目加入书签后,你可以在书签列表标签页中选择相应的书签以打开这些文件。在书签列表标签页中,你可以通过选中和拖动来重新排列书签。
在设置—-核心插件—-书签开启后,会在侧边栏的标签页中出现,标签一样的图标,点击即可显示收藏的书签

可以理解为网页添加为书签,方便自己查找切换
在书签列表中:
- 在书签列表标签页的顶部点击收藏当前标签页
在文件列表中:
- 在文件列表中右键单击文件,然后点击收藏
在文件列表中右键单击文件夹,然后点击收藏。相当于创建了文件夹的软连接,点击即可切换
- 输入一个检索式在侧边栏的标签页中找到搜索
- 点击搜索结果后的三个点,打开菜单。
- 点击收藏。

要收藏图谱,请右键单击包含关系图谱的标签页,然后点击收藏。
无法收藏本地图表。
要收藏章节(小标题下的内容),请右键单击小标题,然后点击收藏当前章节。收藏之后会生成链接,点击收藏链接的时候会显示高亮文本
- 选中要收藏的块,按下Ctrl+PCtrl+P 打开命令面板
- 选择收藏当前块的命令即可
- 在核心插件中启用网页浏览器
- 点击网页就会导航导想要收藏的链接
- 在地址栏中,点击阅读器图标旁边的三个点图标
- 点击收藏

在书签列表中,中右键点击书签即可打开菜单,点击菜单中的移除即可。
- 添加书签组
- 在书签列表顶部点击新书签组,要将书签移动到另一个组中,选中书签并拖动到想要移动到的分组中即可
在文件列表中:
- 通过按住Alt来选择多个文件或按住Shift来选择连续的多个文件
- 右键单击所选的任何一个文件,然后选择收藏
在标签组中: 1. 点击标签组右上角的向下箭头 2. 选择收藏当前 x 个标签页,其中 x 是标签组中的标签页数量
6.3 关系图谱
关系图谱是一个核心插件,可以让你直观地看到仓库中笔记之间的关系。
关系图谱默认是打开的,在核心设置中即可查看
在左上角的功能区,能够看到树一样的图标,点击查看关系图谱
- 点代表笔记,或称为 节点
- 连线表示两个节点之间的内部链接
某一节点关联的节点越多,该节点就会变得越大
关系图谱支持交互操作:
- 将鼠标悬停在每个节点上,可以高亮与该节点相关的连接。
- 点击节点可以打开该笔记。
- 右键点击一个节点可以打开该笔记的上下文菜单。
在图谱中浏览:
- 使用鼠标滚轮对图谱进行放大和缩小,或使用+和-键。
- 通过拖动鼠标或使用方向键来水平移动图谱。

设置
在左侧功能区点击功能图标打开图谱之后,在图谱右上角的齿轮图标打开设置
- 筛选
- 搜索框:允许你根据搜索词筛选笔记。要了解如何编写复杂的搜索词
- 标签:是否在图中显示标签。
- 附件:是否在图中显示附件。
- 仅显示已创建的笔记:是否只显示那些已经被实际创建的笔记。Obsidian 允许只创建笔记链接而不实际创建笔记,所以这个选项可以帮助你只查看实际创建的笔记。
- 孤立文件:是否显示那些没有任何笔记链接的文件
- 颜色组
颜色组设置可以让你将笔记分组,并为每个分组中的节点染上指定的颜色
- 点击新建颜色组
- 在搜索框中,通过搜索词确定该组所包含的笔记
- 点击彩色圆圈为该组选择一种颜色。
- 外观
控制图谱中节点和连接线的外观
- 箭头:是否在连接线上显示箭头、以显示每个链接的方向
- 文本透明度:控制每个节点名称文本的透明度
- 节点大小:控制表示每个节点的大小
- 连线粗细:整体控制连接线的宽度
- 播放动画:开始播放图谱的生长动画
- 力度
这部分设置用于控制作用于图谱中每个节点的力量
- 图谱向心力:控制图谱的紧凑程度。数值越高,节点越集中,创建的图谱就越接近圆
- 节点间的排斥力:控制一个节点对其他节点的排斥程度
- 相连节点间的吸引力:控制每对连接节点间的吸引力。如果将连接比作橡皮筋,吸引力控制着橡皮筋的松紧程度
- 连线长度:控制相连笔记之间连线的长度
要打开局部关系图,请使用打开局部关系图命令。尽管关系图谱显示了仓库中的所有笔记,但局部关系图相对更有用一些,因为其展示了当前笔记的关系情况
6.4 出链
出链是一个核心插件,可以一目了然地显示当前笔记中的链接(出去的链接),以及潜在的可创建链接
出链可以理解为这篇文章中包含的其他笔记的链接,可以方便查看当前笔记指向哪些笔记
出链标签页位于右侧边栏中(像个回形针一样的图标),包含以下部分
- 当前笔记中的链接列出了当前笔记中的所有链接。点击链接即可打开对应的笔记
- 当前笔记中潜在的链接列出了当前笔记中与仓库内其他笔记名称或别名匹配的文本。潜在的链接可以帮助你发现尚未注意到的链接。
潜在的链接可能指向具有相同名称的不同笔记。要显示笔记的完整路径,请将鼠标悬停在带有笔记名称的按钮上。
6.5 反向链接
使用反向链接插件,你可以查看当前笔记的所有反向链接
一篇笔记的反向链接是指从另一篇笔记中指向该笔记的链接
相当于别的文章引用当前笔记的链接,方便查看哪些文章引用了当前笔记
显示反向链接
反向链接插件会显示当前标签页中笔记的反向链接。这包括了部分:链接当前文件和提到当前文件名
- 链接当前文件是指那些确实链接了当前文件的笔记
- 提到当前文件名是提到了当前文件名称、但尚未链接当前文件的笔记
点击右侧的反向链接列表标签页之后,右侧标签页组会出现几种选择
- 折叠:你可以选择是否展开查看这两个部分包含的笔记。
- 显示更多上下文:你可以选择是否完整显示包含当前文件名的段落。
- 更改排序顺序:选择笔记的排列顺序。
- 过滤:通过输入检索词,进一步过滤展示的笔记
6.6 命令面板
命令面板插件允许你直接通过键盘运行任何命令,它还能让你浏览所有可用的命令及其键盘快捷键。
所有的Obsidian操作都是通过命令面板来实现的
打开命令面板
- 按下 Ctrl+PCtrl+P 打开命令面板,你也可以通过功能区中的命令面板图标(>_)打开它。
- 在命令面板中输入命令
- 使用方向键导航到该命令
- 然后按 Enter 键运行命令
置顶命令
- 打开设置。
- 在侧边栏中,点击插件选项下的命令面板。
- 在新建置顶命令旁边,点击选择一个命令。
- 从列表中选择你想要置顶的命令。
- 按 Enter

6.7 工作区布局管理
工作区是一个核心插件,可以让你根据情景来切换 Obsidian 的布局。这可以让你在阅读、写作、临时记录等情景下分别使用不同的布局。
自定义页面布局,包括左侧右侧标签页,中间的工作区标签页,快速打开页面布局进行工作
插件保存的每个工作区布局包含了打开的文件、标签页,侧边栏的折叠情况及宽度等信息
保存工作区布局
在功能区
- 在功能区中,点击管理工作区布局
- 为当前工作区布局输入一个名称
- 点击保存

加载工作区布局
在功能区中:在功能区中,点击管理工作区布局,点击要加载的工作区布局旁边的加载按钮。
记得保存一份常用的工作布局,防止把时间浪费在不重要的事情上
6.8 搜索
搜索是一个核心插件,帮助你通过搜索词和运算符在 Obsidian 仓库中查找数据,从而缩小结果范围。
默认情况下,可以在左侧边栏中找到搜索,可以按Ctrl+Shift+FCtrl+Shift+F windows或Cmd+Shift+FCmd+Shift+F mac打开搜索
- 搜索选中文本:如果你在编辑器中选中了文本,然后通过快捷键打开搜索,搜索会显示所选文本的搜索结果
- 搜索最近的搜索词:在搜索词为空时打开搜索,会列出最近使用过的搜索词。点击任意一个即可再次使用该搜索词
- 搜索词
搜索词是你在搜索框中输入的单词或短语。学会高效地编写搜索词可以帮助你快速找到所需内容,即使在大型仓库中也是如此。Obsidian 只搜索笔记和白板的内容。
搜索词中的每个单词在每个文件中独立匹配。要搜索精确短语,请用引号将其包围,要在精确短语中搜索带引号的文本,可以在引号前添加反斜杠()来转义引号
默认情况下,你只能搜索笔记和白板的路径和文件名。要搜索仓库中任何文件的路径或文件名,请使用 path 或 file 运算符。
查找中可以使用逻辑运算符OR,AND,NOT等
- 搜索运算符
搜索运算符可以实现更精细的搜索词,进一步筛选你的结果
| 搜索运算符 | 描述 |
|---|---|
file: |
在文件名中查找文本。匹配仓库中的任何文件。 示例: file:.jpg 或 file:202209。 |
path: |
在文件路径中查找文本。匹配仓库中的任何文件。 示例: path:"Daily notes/2022-07"。 |
content: |
在文件内容中查找文本。 示例: content:"happy cat"。 |
match-case: |
区分大小写的匹配。 示例: match-case:HappyCat。 |
ignore-case: |
不区分大小写的匹配。 示例: ignore-case:ikea。 |
tag: |
在文件中查找标签。 示例: tag:#work。注意: - 搜索 tag:#work 不会返回 #myjob/work 的结果。- 由于 tag: 会忽略代码块和非 Markdown 内容中的匹配,因此它通常比普通全文搜索 #work 更快、更准确。 |
line: |
查找至少包含一行匹配 x 的文件。 示例: line:(mix flour)。注意:使用 -line 会否定搜索,意味着它将查找没有任何行匹配 x 的文件。 |
block: |
在同一块中查找匹配项。 示例: block:(dog cat)。注意:由于 block: 需要搜索解析每个文件中的 Markdown 内容,这可能会导致搜索耗时更长。 |
section: |
在同一节(两个标题之间的文本)中查找匹配项。 示例: section:(dog cat)。 |
task: |
在任务中逐块查找匹配项。 示例: task:call。 |
task-todo: |
在未完成的任务中逐块查找匹配项。 示例: task-todo:call。 |
task-done: |
在已完成的任务中逐块查找匹配项。 示例: task-done:call。 |
- 搜索属性
[status:xxx]:这是在告诉系统,“请去检查文件的 status 这个属性,同时可以连用逻辑运算符[status:Draft OR Published]括号
()的作用是把条件打包在一起
- 使用正则表达式
正则表达式是描述文本模式的一组字符。要在搜索词中使用正则表达式,请用正斜杠(/)将表达式包围
/\d{4}-\d{2}-\d{2}/匹配 ISO 8601 日期,例如 2022-01-01path:/\d{4}-\d{2}-\d{2}/返回文件路径中包含日期的文件。
6.9 文件插件
- 文件列表
文件列表是一个核心插件,可让你管理仓库中的文件和文件夹。你可以浏览仓库中的笔记和其他支持的文件格式,并执行许多常见的文件操作:
- 创建、删除和重命名文件及文件夹
- 通过拖放来移动文件和文件夹
- 使用右键菜单访问所有可用操作
可以理解为所有文件的操作都是文件插件来控制的,包括创建新笔记,创建新文件夹,更改排序方式,重命名文件或文件夹,移动文件或文件夹
当你打开一篇笔记时,文件列表可以自动滚动到该笔记在文件夹树中的位置并高亮显示。这有助于你在仓库中追踪当前笔记的位置
- 点击文件列表顶部的自动定位当前文件
启用后,文件列表将自动跟随并显示当前打开的笔记。
- 文件恢复
文件恢复是一个核心插件,它通过定期自动保存笔记的完整快照,保护你的工作免受意外删除、文件损坏或不需要的更改的影响。
文件恢复并不是一个完整的备份方案,我们建议你同时单独备份你的 Obsidian 文件
默认情况下,快照之间的最短保存间隔为 5 分钟,保留时间为 7 天。你可以在设置 → 核心插件 → 文件恢复中配置这两个间隔。
快照保存在全局设置中,位于仓库之外,以应对仓库相关的数据丢失。这意味着快照是通过笔记的绝对路径来存储的。如果你最近移动了仓库,你可能需要将其移回快照创建时所在的位置。
恢复快照
- 打开设置 - 在侧边栏中,选择核心插件下的文件恢复 - 在快照下,选择查看。 - 在文件名称字段中,开始输入你想恢复的文件的名称,你会看到一个建议列表 - 选择文件,按 Enter 键,你会看到可用的快照列表 - 选择你想恢复的快照 (可复制或者恢复) - 显示差异,就像git diff一样 ,显示快照版本之间添加、删除或修改的内容。
6.10 日记
- 创建日志
日记插件是一个核心插件,可以打开当日的日记。如果当日日记不存在,则会创建该日记。你可以使用这个插件创建日记,从而记录待办事项列表,或者记录当天有意思的事情。
打开方法:
- 点击功能区中的打开/创建今天的日记
- 在命令面板中执行打开/创建今天的日记命令
- 使用快捷键执行打开/创建今天的日记命令
你可以使用日期格式功能自动将日记整理到特定子文件夹中
在设置中找到日志,然后选择自定义设置日期格式,设置成YYYY/MMMM/YYYY-MMM-DD,创建日志的时候就会自动归类到指定的文件夹中
当使用创建日志的功能的时候,就会创建出来子文件夹
- 使用模板创建
如果你需要让日记具有相同的结构,则可以使用日记模板功能。这个功能会在创建日记时自动向日记中插入预先设置好的内容。
- 创建一个名为”日记模板”的新笔记,并输入以下文本(或任何你觉得合适的内容):
# {{date:YYYY-MM-DD}}
## 任务
- [ ]- 打开设置, 在侧栏中,点击插件选项下的日记选项
- 在日记模板位置设置项旁边的文本框中,选择”日记模板”笔记。
就是先创建一个基础的模板,然后把模板位置放入到在日记模板位置设置项旁边的文本框中,然后选择创建的模板名称
- 日记和属性
当启用日记插件后,如果你的其他笔记中使用了日期属性的话,Obsidian 会自动尝试将该日期链接到对应的日记上。例如,如果一个名为example.md的笔记中包含日期属性2023-01-01,这个日期将会在实时预览模式下部分转换为可跳转至《2023-01-01》这篇日记的链接。
如果一篇笔记里有多个日期属性,Obsidian 会分别处理每个日期。只要某个属性的值被识别为日期,并且能匹配到对应的 Daily Note 文件,它就会变成可点击链接
6.11 模板
模板是一个核心插件,可让你将预定义的文本片段插入到当前活动笔记中。
核心是要设置好模板文件夹的位置,核心插件 → 模板 → 模板文件夹位置中,输入包含模板的文件夹路径。
- 模板变量
可以使用模板变量为模板添加动态信息。当你插入包含模板变量的模板时,模板插件会将变量替换为对应的值
| 变量 | 描述 |
|---|---|
{title} |
当前活动笔记的标题。 |
{date} |
今天的日期,默认格式:YYYY-MM-DD。 |
{time} |
当前时间,默认格式:HH:mm。 |
要设置格式字符串,请在变量后添加冒号(:),然后跟上 Moment.js 格式标记组成的字符串,例如 {date:YYYY-MM-DD}
- 创建模板
在模板文件夹中,创建一篇笔记,写入你希望在使用模板时出现的内容。你可以使用模板变量来插入动态文本,例如当前日期。
下面是一个读书笔记模板,选中一个文件夹然后创建文本文件,记住把文件夹写入到设置中去
---
title: "{{title}}"
type: reading-note
created: "{{date}} {{time}}"
book_title: ""
author: ""
translator: ""
publisher: ""
publish_date:
isbn:
status: unread
rating:
category:
tags:
- reading
- book
start_date:
finish_date:
cover:
source:
---
# {{title}}
> 阅读日期:{{date}} {{time}}
## 📚 书籍信息
| 项目 | 内容 |
|------|------|
| 书名 | |
| 作者 | |
| 译者 | |
| 出版社 | |
| 出版时间 | |
| ISBN | |
| 阅读状态 | ☐ 未读 ☐ 阅读中 ☐ 已读 |
| 评分 | ⭐⭐⭐⭐⭐ |
---
## 🎯 阅读目的
为什么阅读这本书?
---
## 📝 内容摘要
### 核心观点
-
-
-
---
### 第1章
#### 内容摘要
---
### 第3章
#### 内容摘要
-
#### 关键摘录
>
#### 我的思考
---
## 🔗 关联笔记
- [[ ]]
- [[ ]]
- [[ ]]
---
## 📌 一句话总结
>在实时预览中,笔记属性面板可能会覆盖没有加引号的模板变量。
为了避免出现这种情况,最好把笔记属性设置为源码,在设置里即可调整
- 将模板插入到当前活动笔记
- 在新建的文件中选中,然后在功能区中点击插入模板
- 选择要在当前活动笔记光标位置处插入的模板,选中模板
模板内容将插入到当前光标位置。如果光标不在笔记正文中,内容将插入到上次光标所在的位置
6.12 笔记重组
笔记重组是一个核心插件,可以让你将两篇笔记合并,或者将一篇笔记的部分内容拆分成新笔记。
- 合并笔记
合并笔记功能会将一篇笔记添加到另一篇笔记中,并删除第一篇笔记。笔记合并功能会自动更新对第一篇笔记的所有链接,使它们指向合并后的笔记。
Obsidian支持多种方式的合并
- 新的A追加到B文档,在合并的时候按
Enter - 新的A插入到B文档,在合并的时候按
shift+Enter - 新建的C包含A和B文档, 在合并的时候按
Cmd+Enter
可以通过多种方式完成合并
- 文件列表中,也就是左侧的文件边栏,右键点击需要合并的笔记,点击 将该笔记合并到……,选择文件的方式(上述的三种)完成合并
- 命名面板,当前笔记合并到其他笔记中
- 移动笔记内容
笔记重组插件支持将光标所在的章节,或所选中的内容移动到其他笔记中
Enter:将所选内容移动到目标笔记的 末尾。Shift+Enter:将所选内容移动到目标笔记的 开头。Ctrl+Enter(或 macOS 上的 Cmd+Enter):新建一个包含所选文本的新笔记。
同样的方法,内容的话选中右键 选择合并
- 模板文件
通过模板,可以将内容以自定义格式并入新笔记,让你能够使用模板
# {{newTitle}}
## 📌 合并内容
{{content}}
---
## 📎 来源笔记
{{fromTitle}}
---
## 🕒 合并时间
{{date:YYYY-MM-DD HH:mm}}
---
## 🧠 后续思考
- | 变量 | 描述 |
|---|---|
{content} |
要合并的内容,或需要移动的文本。如果不包含此变量,笔记合并功能默认会在插入所有模板内容后,再插入合并/移动内容。 |
{fromTitle} |
源笔记的名称(被合并进来的那篇笔记标题)。 |
{newTitle} |
目标笔记的名称(合并后生成或写入的笔记标题)。 |
{date:FORMAT} |
新笔记的创建日期,可以自定义格式。例如:{date:YYYY-MM-DD}。 |
6.13 白板
白板是一个用于视觉笔记记录的核心插件。通过白板,你可以在一张无限大的画布上排列组合你的笔记,并将其与其他笔记、附件和网页连接起来
Obsidian 将白板保存为
.canvas文件,使用开放的 JSON Canvas 格式
- 创建白板
可以通过命令面板/文件列表右键单击/左侧功能区点击新建白板等方式
- 添加卡片
你可以将 Obsidian 或其他应用程序中的文件或文本拖入你的白板,使其成为白板上的一张卡片。Markdown 文件、图片、音频、PDF 或甚至 Obsidian 无法识别的文件类型都可以成为白板上的卡片
相当于把内容当作卡片插入到白布上去,进行拼接
- 添加文本卡片
文本卡片就是一个纯粹的文本框,你可以像在笔记中一样在其中使用 Markdown、链接、代码块等内容。和普通的笔记不同,文本卡片不会在文件列表中生成笔记文件,其内容完全保存在白板文件中
- 点击下方的便签图标,然后点击图标后移动鼠标,选择位置后松开即可;可以用双击白板空白处来添加文本卡片
可以将文本卡片转换为普通的笔记文件
- 右键单击文本卡片,然后点击转换为笔记
- 输入笔记名称,然后点击保存
- 添加笔记卡片
笔记卡片是指将仓库中的笔记作为卡片插入到白板中。要将仓库中的笔记添加到白板中:
- 点击或点击后拖动白板底部的文档图标
- 选择要添加的笔记
也可以直接从左侧文件栏中文件列表中笔记拖拽到白板中
- 添加媒体卡片
媒体卡片是指将仓库中的媒体文件作为卡片插入到白板中。要将仓库中的媒体文件添加到白板中:
- 点击或点击后拖动白板底部的图片图标
- 选择要添加的媒体文件
Canavs也算媒体的一种,包括之前介绍的文件形式,包括图片,视频,音频等
- 添加网页卡片
网页卡片是指将浏览器中的网页作为卡片插入到白板中。要在你的白板中添加网页:
- 右键单击画布,然后选择添加网页
- 输入网页的地址,然后点击保存
- 编辑和移除卡片
- 可以从文件列表中拖动一个文件夹到白板中,这样将会把该文件夹内所有文件作为卡片插入白板
- 双击文本卡片或笔记卡片即可编辑其内容。点击卡片外部任意位置后即退出编辑, 也可以按 Escape 退出编辑卡片
- 删除就是常规的操作
- 替换卡片内容,也是右键选择替换即可
- 操作卡片
- 选择卡片
- 点击选择单张卡片,或者通过滑动鼠标来选中多张卡
- 可以按
shift来点击卡片选中或者取消多张卡片 - 按下
Ctrl+a可以选中白板中所有的卡片
- 整理卡片
拖动所选择的卡片可以移动它们
按下
Ctrl(或 macOS 上的Option)并拖动就可以复制一张所选择的卡片
- 在拖动时按下
Shift可以强制卡片直线移动
- 调整卡片大小
在点击卡片之后,鼠标会变成箭头形状,然后才能调整边缘大小;变成圆点是用来连接线的不能调整大小
- 在调整大小时按下 Alt 可以禁用卡片间的吸附效果
- 在调整大小时按下 Shift 可以保持卡片的纵横比
- 连接卡片
可以在卡片之间创建连接线以表明关系。添加颜色和文字说明来描述它们之间的联系
- 连接两张卡片
- 将鼠标悬停在一张卡片边缘上,直到看到一个圆点
- 将圆点拖到另一个卡片的边缘就可以连接它们
如果你拖动圆点但不将其放到另一张卡片,会提醒你另一端创建一张新卡片,如果不创建连接线会自动取消
- 断开连接线
- 将鼠标悬停在连接线上,直到连接线高亮
- 拖动连接线使离开一张卡片即可
- 右键单击连接线并点击工具栏中的移除按钮来断开连接线
- 跟随连接
如果连接的两张卡片相距很远,你可以右键单击连接线,然后选择跟随链接即可跳转到所连接的另一张卡片。
相当于离得远了,你想看到和哪个卡片有关联,帮你快速切换到卡片
- 为连接添加说明和更改颜色
为连接线添加文字以描述两张卡片之间的关系
- 双击连接线
- 输入文字,然后按 Escape 或点击画布的任何位置退出编辑
- 卡片编组
- 创建一个空白分组: 右键单击白板,然后点击创建分组
- 选中多张卡片然后右键单击任何已选中的卡片,然后选择创建分组
- 分组可以多层嵌套
- 浏览白板
通过平移和缩放来浏览白板,要垂直和水平移动白板,也称为 平移
- 平移白板
- 按下
Space空格键,然后鼠标拖动白板 - 使用鼠标中键拖动白板
- 滚动鼠标以垂直移动,按下 Shift 滚动可以水平移动
- 缩放白板
要缩放白板,按下 Space 或Ctrl(或 macOS 上的 Cmd)后滚动鼠标滚轮即可。或者,在右上角的工具栏中使用放大和缩小按钮。
- 重置白板
要将缩放恢复为默认值,请在右上角的工具栏中点击重置缩放。
- 导出白板
基本上导出的是全部白板或者部分白板内容,导出为图片PNG格式
- 对齐方式
Obsidian提供了多种方式的对齐方式,按需选择即可
- 对齐网格
- 对齐物品
6.14 小插件
- 大纲
大纲是一个核心插件,用于列出当前笔记中的标题. 要导航到笔记中的某个部分,请在大纲中点击对应的标题,要重新排列笔记中的各个部分,请在大纲中点击并拖动标题。
- 字数统计
字数统计是一个核心插件,用于显示当前笔记的字数和字符数。在桌面端,字数统计显示在状态栏中。在移动端,字数统计显示在右侧边栏的顶部。字数统计支持中日韩(CJK)语言,这些语言不使用空格来分隔单词。
- 属性列表
属性列表是一个核心插件,它添加了两个侧边栏视图,可以用来管理属性:
- 笔记属性显示当前活动笔记的属性视图
- 添加笔记属性显示仓库中所有属性及其类型的列表
在右侧点击属性列表,然后可以进行操作
- 按名称或使用频率(在仓库中的总使用次数)对属性进行排序
- 点击某个属性以打开搜索视图,其中会预填属性搜索语法
- 右键点击某个属性以在全局范围内重命名它

- 幻灯片
幻灯片的插件,是基于笔记来创建演示文稿,就是换个形式来展示文档
找到笔记,然后右键选择点击开始演示即可
要在幻灯片之间翻页,请点击右下角的左右箭头,或按键盘上的左右方向键, 按下空格键来翻到下一张幻灯,停止演示,按 Escape 键或点击演示文稿右上角的关闭按钮
# 使用 Slides 进行演示
演示如何使用Slides构建演示文稿。
---
## 格式化
你可以使用常规的 Markdown 格式,比如 *斜体* 和 **粗体** 文本。
---
## 幻灯片
使用 `---` 来分隔幻灯片。- 录音机
录音机是一个核心插件,可以让你在 Obsidian 笔记中录制并保存音频。通过录音机插件,你可以在课堂、会议或其他无法快速打字的重要场景中录制详细内容.
- 新建一篇笔记或打开一篇已有的笔记
- 在功能区中,点击开始/结束录音开始录音。当图标变色时,表示录音已经开始。
- 再次点击该图标即可停止录音,并将录音添加到笔记中。
Obsidian 会将录制的音频文件保存到你的仓库中,并将其嵌入到当前笔记的末尾
- 快速切换
快速切换是一个核心插件,可让你仅通过键盘搜索和打开笔记。
默认启用快速切换,有多种方式可以打开它
- 使用Ctrl+OCtrl+O打开快速切换
- 在功能区,点击打开快速切换
- 输入内容以按名称或别名搜索笔记,使用方向键导航到目标笔记
当仓库中的项目数量达到 10,000 个时,自动补全功能会切换为更简单的结果算法,以保持应用的最佳性能。
- 斜杠命令
斜杠命令是一个核心插件,它允许你在编辑器中通过在行首或任意空格后输入斜杠(/)来执行命令。
类似Rstudio中一样,使用
/调用命令或者像Claude Code中/调用skills,都是相通的
- 在编辑器中输入斜杠(/)。
- 输入你想执行的命令名称,以搜索可用命令列表。
- 使用方向键导航到对应命令。
- 按下 Enter 键。
如需退出斜杠命令搜索而不执行任何命令,请按 Esc 或 Space 键
- 漫游笔记
漫游笔记是一个核心插件,它会随机打开仓库中的一篇笔记。重新发现笔记以添加新的见解,或链接到最近添加的笔记。
就是在左侧功能区点三个点的图标,然后随机给你一篇 让你有新的想法
- 脚注视图
脚注视图是一个核心插件,用于列出当前笔记中的所有脚注。
点击脚注即可编辑其文本。你也可以跳转到脚注在笔记中的位置。
- 时间戳笔记生成器
时间戳笔记生成器是一个核心插件,它可以让你创建以时间命名的笔记,也称为 Zettelkasten 式笔记。和日志是类似的,但时间戳笔记生成器允许你创建任意数量的笔记,而不仅仅是每天一篇。
6.9 第三方插件
插件是 Obsidian 的扩展,可以添加新的功能或增强现有功能。Obsidian 的插件生态系统非常庞大,有数百个插件可供选择。
浏览和安装社区插件
- 在设置中打开
- 选择关闭安全模式
- 选择浏览以列出所有可用的社区插件

- 选择你想安装的插件
- 选择安装即可
Obsidian 需要在插件安装之后,设置启动才能运行插件 设置 → 社区插件 → 已安装插件下的社区插件列表中启用
7. 数据库
数据库是一个核心插件,可让你为笔记创建类似数据库的视图。使用数据库,你可以查看、编辑、排序和筛选文件及其属性。数据库可以帮助你组织从项目到旅行计划、阅读清单等各种内容。数据库可以帮助你组织从项目到旅行计划、阅读清单等各种内容。
每个数据库可以有多个视图,支持不同的布局,如表格和卡片。下面是一个表格视图的示例,其中每一行是一个文件,每一列是该文件的一个属性。

Obsidian 数据库中的所有数据都存储在本地的 Markdown 文件及其属性中。视图通过Bases 语法来描述,可以保存为 .base 文件,或嵌入到 Markdown 文件的代码块中。
视图可以使用不同的布局来显示。第三方插件可以添加额外的布局
8. Obsidian Web Clipper 网页剪藏器
Obsidian Web Clipper 是一款免费的浏览器扩展,可让你高亮页面并将网页内容保存到你的仓库中
建议首先设置好存放文件的位置,便于归纳和整理,在Obsidian的设置中找到文件与链接

8.1 安装 Obsidian Web Clipper
从你所使用浏览器的官方扩展商店获取 Obsidian Web Clipper 扩展:
- Chrome:在 Chrome Web Store 中搜索 “Obsidian Web Clipper” 并安装
- Firefox:在 Firefox 和Firefox monile 中搜索 “Obsidian Web Clipper” 并安装
- Edge:在 Microsoft Edge 附加组件 中搜索 “Obsidian Web Clipper” 并安装
- Safari拓展安装,会跳转到Appstore中下载App,然后需要在IOS设置中选择Safari中给予obsidian权限(设置—-safari浏览器–拓展–Obsidiana Web Clipper)

8.2 剪藏网页
最原始的保存方式
安装插件拓展完成后,就可通过多种方式访问它
- 浏览器工具栏上的
Obsidian图标 - 右键菜单,在正在浏览的页面点击右键能看到
Obsidian的选项 - 自己设置的快捷键
要将页面保存到Obsidian,直接点击保存到Obsidian按钮,会弹出打开`Obsidian的窗口,然后跳转到Obsidian软件,会默认生成一个Clippings文件夹(也可以自定义),将页面保存到这个文件夹下,生成新的md文档

捕获页面
默认情况下,Obsidian Web Clipper 会尝试智能提取页面的主要文章内容,排除页面上的其他元素。
打开拓展时,Obsidian Web Clipper 会根据你的模板设置从当前网页中提取数据。你可以创建自己的模板,并使用变量和筛选来自定义输出(后续介绍设置模版)
- 如果存在自定义模板,则使用你的模板
- 如果存在选中内容,则使用选中内容。你可以使用 Ctrl/Cmd+A 选择整个页面
- 如果存在任何高亮内容,则使用
==高亮内容== - 自动识别并提取主要文章内容
- 自动忽略广告、导航栏等无关元素
下载图片
使用 Obsidian Web Clipper 时,图片不会自动下载。图片会链接到其网络 URL。这可以节省仓库空间,但意味着在离线状态下或 URL 失效时图片将无法访问(相当于给的是图片的链接,如果要保存图片就使用)
你可以在 Obsidian 中使用命令下载当前文件内的所有附件来下载任何文件中的图片。此命令也可以在 Obsidian 中映射为快捷键
- 在设置中打开第三方插件–安装
Local Image插件 - 使用
Command + P打开控制面板 - 输入Local Image: Download Images Locally

8.3 界面功能
Obsidian Web Clipper 界面分为四个部分:
- 顶部栏,你可以在此切换模板、开启高亮、阅读视图,以及访问设置
- 属性,显示从页面中提取的元数据,这些数据将作为属性保存在 Obsidian 中
- 笔记内容,将保存到 Obsidian 中的内容
- 底部栏,允许你选择仓库和文件夹,并添加到 Obsidian
顶部栏功能:
- 模板切换器,用于使用在扩展设置中保存的模板。
- 更多按钮,显示可在模板中使用的页面变量
- 高亮按钮,用于开启高亮
- 阅读视图按钮,用于在阅读模式下打开页面
- 嵌入按钮,用于将 Web Clipper 从弹出窗口移入页面中
- 设置按钮,用于打开扩展设置
底部栏功能:
- 添加到 Obsidian 按钮,将数据保存到 Obsidian
- 仓库下拉菜单,用于在 Web Clipper 设置中保存的仓库之间切换
- 文件夹字段,用于定义保存到哪个文件夹
- 解释器,用于在页面上运行自然语言提示
- 阅读器
Web Clipper 内置了一个名为阅读器的阅读视图,可以去除网页中的杂乱元素,仅以简洁、易读的格式呈现文章主要内容
激活方式
- 点击浏览器顶部的obsidian按钮–选择扩展面板中的书本图标
- 右键菜单,然后选择obsidian–查看阅读模式,点击即可
你也可以将扩展按钮设置为一键打开阅读器。在 Web Clipper 设置中前往通用 → 行为 → 打开行为,然后选择阅读器
工作原理:
阅读器会从页面中提取主要内容。原始页面将被替换为简洁的阅读视图,文章标题、作者、发布日期和来源域名;文章主要内容,保留图片和格式;对于包含多个标题的文章,侧边栏中会显示大纲;代码块的语法高亮;点击脚注时会以行内弹出框的形式显示
自定义阅读视图
| 设置项 | 描述 |
|---|---|
| 字体 | 添加系统中已安装的字体 |
| 字体大小 | 调整文本大小 |
| 行高 | 行与行之间的间距 |
| 行宽 | 内容区域的最大宽度 |
| 外观 | 选择浅色或深色外观 |
| 主题 | 选择配色方案 |
| 自定义 CSS | 应用于页面的额外 CSS |
CSS可以让AI辅助你 写一个自定义的页面
- 高亮
Web Clipper 允许你高亮网页上的文本,并选择你想要保存到 Obsidian 的元素。高亮内容会被保存,这样当你再次访问页面时可以查看
高亮相当于当你浏览网页的时候,看到感兴趣的标记颜色,再你下次看到的时候 你是能看到标记颜色的
有多种方式激活高亮工具,来自动将选中内容添加标记
- 扩展面板或阅读器工具栏中的高亮图标
- 右键菜单,在你正在浏览的网页上右键点击。
- 快捷键,可在扩展程序设置中自定义(快捷键定义与系统和浏览器有关,默认是Option+shift+h,注意是英文模式,中文会失效)

将高亮内容插入剪藏笔记中有三个设置: - 高亮页面内容 — 使用 语法 ==highlight== 直接在文本中添加高亮。 - 替换页面内容 — 返回高亮列表,不包含任何页面内容。 - 不做任何操作 — 返回不含高亮的原始内容。
每个模式都有不同的用处,比如做阅读摘要/知识卡片,科研笔记等
创建的所有高亮内容都可以在高亮页面中查看。你可以通过 设置 → 高亮–打开高亮 打开此页面。

- 解释器
Interpreter 是 Web Clipper 的一项功能,允许你使用自然语言与网页进行交互。Interpreter 帮助你捕获和修改想要保存到 Obsidian 的数据。
- 提取特定的文本片段
- 总结或解释信息
- 将文本从一种格式转换为另一种格式
- 将文本翻译为不同的语言
Interpreter 利用语言模型来处理网页上的信息,并使用变量返回结果,你可以将这些变量添加到你的 Web Clipper 模板中。
激活解释器
- 前往 Web Clipper 设置中的 解释器 部分
- 开启解释器
- 配置大模型的供应商和模型API等

- 将需要使用的提示变量添加到模板中(提示词更像是上下文工程和大模型中提示词工程是一样的理解)
- 如果你的模板包含提示变量,当你剪藏页面时,Interpreter 部分将可见。点击解释来处理提示变量。

解释器,更类似于Promoter提示词工程一样的,调用LLM进行处理,在Claudian中,已经能够全部满足,网页收藏更像是浓缩一下内容
- 模板
Web Clipper 允许你创建模板,自动捕获和组织网页中的元数据。示例模板可在 clipper-templates 仓库 中找到
创建或编辑模板
要创建模板,请前往 Web Clipper 设置并点击侧边栏中的新建模板按钮。你也可以在右上角的更多操作菜单中创建副本来复制模板
- 模板(模板名称;模板触发器)
- 位置(行为,笔记名称,笔记位置,保管库)
- 内容(属性,笔记内容)
- 高级(解释器上下文)
也设置了快捷的导入导出模板,本质上是
.json文件
- 自动触发模板
- 模板触发器允许你根据当前页面 URL 或 schema.org 数据自动选择模板。你可以为每个模板定义多条规则,每行一条
- URL匹配
- 简单匹配会在当前页面 URL 以给定模式开头时触发模板;可以使用正则表达式根据更复杂的 URL 模式触发模板
Obsidian作者也提供了一些模板,可以直接把json文件复制到新增模板中,按照自己的需求进行更改即可
- 变量
Web Clipper 模板可以使用变量来自动在模板中预填充页面数据(在拓展中点击… 就能看到全部的变量)。变量可以用在笔记名称、笔记位置、属性和笔记内容中。
预设变量根据页面内容自动生成。它们通常适用于大多数网站
| 变量 | 描述 |
|---|---|
| {{author}} | 页面作者 |
| {{content}} | 文章内容、高亮内容或选中文本(Markdown) |
| {{contentHtml}} | 文章内容、高亮内容或选中文本(HTML) |
| {{date}} | 当前日期(可用 date 筛选器格式化) |
| {{description}} | 描述或摘录 |
| {{domain}} | 域名 |
| {{favicon}} | 网站图标 URL |
| {{fullHtml}} | 完整页面的未处理 HTML |
| {{highlights}} | 包含文本和时间戳的高亮内容 |
| {{image}} | 社交分享图片 URL |
| {{published}} | 发布日期(可用 date 筛选器格式化) |
| {{selection}} | 选中文本(Markdown) |
| {{selectionHtml}} | 选中文本(HTML) |
| {{site}} | 网站名称或发布者 |
| {{title}} | 页面标题 |
| {{time}} | 当前日期和时间 |
| {{url}} | 当前页面 URL |
| {{words}} | 字数统计 |
提示变量
提示变量利用语言模型,通过自然语言提取和修改数据。提示变量需要启用并配置 解释器。
提示变量使用 {"页面的摘要"}语法。提示周围的双引号很重要,它将提示与预设变量区分开来。
Meta 变量
Meta 变量(相当于网站的一些参数变量)允许你从页面的 meta 元素中提取数据,包括用于填充社交分享预览的 Open Graph 数据。
- {{meta:name}} 返回具有给定名称的 meta name 标签的内容,例如 {{meta:name:description}} 用于 description meta 标签。
- {{meta:property}} 返回具有给定属性的 meta property 标签的内容
Schema.org 变量
Schema 变量允许你从页面的 schema.org JSON-LD 中提取数据。Schema.org 数据还可用于自动触发模板 - {{schema:@Type:key}} 返回 schema 中键的值。 - {{schema:@Type:parent.child}} 返回嵌套属性的值。
当你不知道或不关心具体的 schema 类型,但知道要查找的属性名称时,这种简写特别有用。
9. 第三方插件
脚注
这是引用文本↩︎











