了解如何使用_内部链接_从笔记中链接到其他笔记、附件和文件。通过链接笔记,你可以创建一个知识网络。 ^b15695
当你重命名文件时,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)`
以上示例是等价的,它们在编辑器中显示方式相同,并且链接到同一篇笔记。
> [!note] 备注
> 使用 Markdown 格式时,请确保对链接目标进行 [URL 编码](https://en.wikipedia.org/wiki/Percent-encoding)。例如,空格应编码为 `%20`。
默认情况下,由于 Wiki 链接格式更加紧凑,Obsidian 会使用 Wiki 链接格式生成链接。如果互操作性对你很重要,可以禁用 Wiki 链接并改用 Markdown 链接。
要使用 Markdown 格式:
1. 打开**[[设置]]**。
2. 在**文件与链接**下,禁用**使用 \[\[Wiki 链接\]\]**。
即使禁用了 Wiki 链接格式,你仍然可以通过输入两个方括号 `[[` 来自动补全链接。当你选择建议的文件时,Obsidian 会生成 Markdown 链接。
> [!note] 无效字符
> 包含以下字符的字符串可能无法作为链接使用:`# | ^ : %% [[ ]]`。
>
> 我们建议避免使用这些字符,并遵循[安全的文件命名规范](https://stackoverflow.com/questions/1976007/what-characters-are-forbidden-in-windows-and-linux-directory-names)。
## 链接到文件
要在编辑模式下创建链接,可以使用以下任一方式:
- 在编辑器中输入 `[[`,然后选择要链接的文件。
- 在编辑器中选中文本,然后输入 `[[`。
- 打开[[命令面板]],然后选择"插入内部链接"。
![[快速切换#^search-autocomplete-large]]
虽然你可以链接到任何[[支持的文件格式]],但链接到 Markdown 以外的文件格式时需要包含扩展名,例如 `[[Figure 1.png]]`。
> [!tip] 在内部链接前加上感叹号(!)可以嵌入链接的内容。更多详情请参阅[[插入文件]]。
> [!info] 忽略文件
> 匹配[[设置#忽略文件|忽略文件]]模式的文件在创建内部链接时会在链接建议中被降低优先级。
## 链接到笔记中的标题
你可以链接到笔记中的特定标题,也称为_锚点链接_。
**链接到同一笔记中的标题**
要链接到同一笔记中的标题,输入 `[[#` 即可获取当前笔记中可链接的标题列表。
例如,`[[#预览链接的文件]]` 将创建一个指向[[#预览链接的文件]]的链接。
**链接到其他笔记中的标题**
要链接到其他笔记中的标题,在链接目标末尾添加井号(`#`),后接标题文本。
例如,`[[关于 Obsidian#链接是一等公民]]` 将创建一个指向[[关于 Obsidian#链接是一等公民]]的链接。
**链接到子标题**
你可以为每个子标题添加多个井号。
例如,`[[帮助与支持#Questions and advice#Report bugs and request features]]` 将创建一个指向[[帮助与支持#Questions and advice#Report bugs and request features]]的链接。
**在整个仓库中搜索标题**
要在整个仓库中搜索标题,使用 `[[## header]]` 语法。
例如,`[[##` 将在整个仓库中进行通用搜索,而 `[[## team]]` 将搜索所有包含 _team_ 一词的标题。
> [!info]- 搜索标题链接的截图
>
> ![[internal-links-header.png#interface]]
## 链接到笔记中的块
块是笔记中的一个文本单元,例如段落、引用块或列表项。
你可以通过在链接目标末尾添加 `#^` 和一个唯一的块标识符来链接到一个块。例如:`[[2023-01-01#^37066d]]`。幸运的是,你不需要手动查找标识符——当你输入脱字符(`^`)时,会出现建议列表,让你选择正确的块。
对于*普通段落*,在行末放置一个空格,后接脱字符 `^` 和块标识符:
```md
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. ^37066d
```
对于*结构化块*(列表、引用、标注、表格),块标识符应在单独一行,前后各有一个空行:
```md
> 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.
```
对于*列表中的特定行*,块标识符可以直接放在列表项上:
```mathjax
- Gemmy
$Paperclip / Pen$
^37006f
- Unhelpful assistant
```
> [!warning] 我们不支持链接到引用、标注和表格中的特定部分。
**在整个仓库中搜索块**
你也可以使用 `[[^^block]]` 语法在整个仓库中搜索要链接的块。但是,与[[#链接到笔记中的标题|标题链接]]相比,更多内容会被视为块,因此列表会更长。
> [!info]- 搜索块链接的截图
> ![[link-block-heading.png#interface]]
你还可以通过添加一个空格、脱字符(`^`)和标识符来创建可读的块标识符。块标识符只能包含拉丁字母、数字和连字符。
例如,在块的末尾添加 `^quote-of-the-day`:
```md
"You do not rise to the level of your goals. You fall to the level of your systems." by James Clear ^quote-of-the-day
```
现在你可以通过输入 `[[2023-01-01#^quote-of-the-day]]` 来链接到该块。
> [!warning] 互操作性
> 块引用是 Obsidian 特有的功能,不属于标准 Markdown 格式。包含块引用的链接在 Obsidian 之外无法使用。
## 更改链接的显示文本
默认情况下,Obsidian 会按原样显示链接文本。例如:
- `[[Example]]` 显示为 [[Example]]
- `[[Example#Details]]` 显示为 [[Example#Details]]
你可以通过自定义显示文本来更改链接的显示方式:
**Wiki 链接格式**:
使用竖线(`|`)来更改显示文本。
- `[[Example|自定义名称]]` 显示为 [[Example|自定义名称]]
- `[[Example#Details|章节名称]]` 显示为 [[Example#Details|章节名称]]
**Markdown 格式**:
使用 `[显示文本](链接 URL)` 来自定义链接的显示方式。
- `[自定义名称](Example.md)` 显示为 [自定义名称](Example.md)
- `[章节名称](Example.md#Details)` 显示为 [章节名称](Example.md#Details)
这种方法适用于你想在特定上下文中更改链接外观的一次性场景。如果你想设置一个可以在整个仓库中重复使用的替代链接名称,请考虑使用[[别名]]。
例如,如果你经常将 `[[Three laws of motion]]` 称为 `[[The 3 laws]]`,将"3 laws"添加为别名可以让你直接输入——无需每次都添加自定义显示文本。
> [!tip] 提示
> 当你想在*特定位置*自定义链接的显示方式时,使用[[#更改链接的显示文本|链接显示文本]]。
>
> 当你想在整个仓库中使用*不同名称*引用同一篇笔记时,使用[[别名]]。
^callout-internal-links-link-text
## 预览链接的文件
> [!note] 备注
> 要预览链接的文件,你首先需要启用[[页面预览]]。
要预览链接的文件,将鼠标悬停在内部链接上。在编辑模式下,悬停时按住 `Ctrl`(macOS 上为 `Cmd`)。文件内容的预览将显示在光标旁边。