嵌入与引用：图片、笔记块、Callout 提示块

链接是「指向」，嵌入是「搬进来」。在链接前加一个感叹号，目标内容就原地显示在当前笔记里，并且随源文件更新而更新。配合块引用和 Callout 提示块，你能把散落的内容重新组装成视图，而不用复制粘贴任何东西。本章把嵌入系统的语法和玩法讲全。

嵌入笔记与块引用

最基本的嵌入：![[笔记名]] 把整篇笔记内容嵌进当前笔记。更常用的是精确到块：

![[费曼学习法]]                 <!-- 嵌入整篇笔记 -->
![[费曼学习法#基本步骤]]        <!-- 嵌入指定标题章节 -->
![[费曼学习法#^quote-01]]      <!-- 嵌入指定块 -->

块引用（block reference）是嵌入系统的地基。给任意块（段落、列表项、引用、表格、代码块）定义标识符：简单段落在行尾空一格后写 ^id；列表、引用、表格等结构块的标识符要单独占一行，前后留空行：

> 你不会被目标撑起，只会被系统托起。——詹姆斯·克利尔
^quote-01

之后任何地方都可以用 [[费曼学习法#^quote-01]] 引用这个精确段落。建议给常用块起人类可读的 id（如 quote-01），比系统生成的随机码好维护。输入 [[笔记名#^ 时会自动弹出块候选列表，不必背 id。

块引用是 Obsidian 方言，导出到其他平台会失效，这是使用前要接受的取舍。

嵌入附件：图片、音频、PDF

嵌入图片：

![[架构图.png]]          <!-- 原始尺寸 -->
![[架构图.png|600]]      <!-- 指定宽度，等比缩放 -->
![[架构图.png|600x400]]  <!-- 指定宽高 -->

外链图片用 Markdown 语法：![600](https://example.com/img.png)，数字同样控制宽度。表格单元格里调整图片尺寸或写双链别名时，竖线要转义成 \|。

嵌入 PDF 支持定位到页和控制高度：

![[论文.pdf#page=3]]            <!-- 从第 3 页开始显示 -->
![[论文.pdf#height=400]]        <!-- 限制显示高度 -->
![[论文.pdf#page=3&height=400]] <!-- 组合参数 -->

音频文件嵌入后显示为播放器；Canvas 白板也能嵌入（![[白板.canvas]]），但只显示卡片形状不显示卡片内文字，看全貌还是直接打开白板为好。

Callout 提示块：带帽子的引用

Callout 是渲染出醒目样式的提示块，语法是引用块第一行加 [!类型]：

> [!tip] 折叠技巧
> 加号默认展开，减号默认折叠：
> [!faq]- 这里默认是折叠状态
> 隐藏的内容，点标题展开。

Callout 支持嵌套、支持自定义标题、支持 +/- 控制折叠状态。编辑时选中已有内容运行 Insert callout 命令可自动包裹。样式偏好的用户可以用 CSS 片段自定义颜色和图标，主题外观一章会给出示例。

组合玩法：用嵌入搭「视图笔记」

嵌入系统最富生产力的用法，是把笔记当作「乐高底板」，用嵌入块拼装专题视图。比如写一篇《学习方法论总览》：

# 学习方法论总览

## 核心原则
![[费曼学习法#^quote-01]]

## 相关论文摘录
![[注意力机制论文精读#实验结论]]

## 待解决问题
![[问题收件箱#^open-questions]]

源笔记更新，视图笔记自动同步——这就是「一处书写、多处呈现」。常见应用：论文综述页聚合各篇精读的结论块；读书主页嵌入所有书评的评分段落；周报页嵌入本周各日记的待办块（配合块引用的列表嵌入，先给列表定义 id 再 ![[日记#^id]]）。

一个提醒：嵌入会忠实搬运全部格式，被嵌入的内容在两个位置都占阅读注意力，同一内容不要嵌太多层，嵌套中嵌套很快就乱。经验法则是视图笔记最多嵌一层，链路保持扁平。

嵌入解决「内容复用」，下一章的搜索与查询解决「批量定位」——两者结合，你就能搭出自动汇总搜索结果的动态视图。

嵌入常见问题与排错

嵌入体系上手后难免遇到几个小状况，提前给答案：

嵌入显示不出来？ 三步排查：检查目标文件名是否完整（含扩展名的文件如图片、PDF 必须写对后缀）；检查路径（如果两篇笔记不在同一文件夹且文件名有歧义，补全路径更保险）；确认感叹号在双链前面（![[...]] 而不是 [[!...]]）。

嵌入的内容太多了？ 用标题锚点（#章节名）或块引用（#^id）缩小范围。全篇嵌入适合「总览页」，局部嵌入适合「视图页」，根据目的选择。

导出或发布后嵌入失效？ 块引用是 Obsidian 方言，离开 Obsidian 就变成普通文本；官方 Publish 支持嵌入但有限制（如嵌入搜索不支持）。需要跨平台复用的内容，发布前改用普通链接加复制的方式。

表格里嵌入图片错位？ 表格单元格内调整图片尺寸要用转义的竖线 \|，这是 Markdown 表格解析器的标准行为，不是 bug。

嵌入思维：从「复制内容」到「引用内容」

嵌入体系背后是一次内容观念的转变：同一份内容应该只有一个正本，其余位置全部引用。传统笔记习惯里，「把这段话复制到周报」是最自然的动作，代价是同一信息存了 N 份，修改时漏改 N-1 处。嵌入把成本反转过来：正本只改一次，所有引用位置自动更新。

这个思维在团队场景尤其有价值——如果你的 vault 需要产出周报、汇总、文档首页，把它们全部设计成「引用容器」：周报页嵌入各日记的任务块，文档首页嵌入各章节的状态块。你维护的永远是原始内容，汇报视图自动保持最新。这也是为什么本书把嵌入和块引用放在核心功能篇：它不是排版技巧，而是知识管理的复用基础设施。

动手组合：五分钟搭一篇「会议导航页」

嵌入的各项语法单独看都简单，威力在组合。给一个五分钟小练习，把你刚学的三样东西（块引用、嵌入、Callout）串起来。场景：你是常开会的人，要一篇「会议导航页」。

第一步，在每篇会议纪要的「行动项」段落（一个列表块）下方单独一行写上块 id，如 ^actions——只做这一小步，纪要文件零侵入。第二步，新建一篇《会议总控》笔记，正文分三段：第一段用 Callout 写固定说明（纪要命名规则、块 id 约定）；第二段逐条嵌入各纪要的行动项：![[2026-10-20 产品评审#^actions]]；第三段嵌入一个未完成任务查询块作为兜底。第三步，保存切换到阅读视图，你得到一个页面：所有会议的待办自动汇聚，任何一篇纪要更新行动项，这里立刻同步。

五分钟投入，之后每次开会只管照常写纪要，导航页永远自动是新的。这个模式再换个皮就能复用：把「纪要」换成「周记」、「行动项」换成「本周要点」，就成了周报总控；换成「论文」、「结论块」，就成了文献综述草稿。嵌入体系的本质至此清晰——它不是格式技巧，而是让你「只维护正本、处处得到视图」的复用机制。把这个机制用顺手，你的 Obsidian 就从笔记本升级成了内容引擎。

图片管理的配套设置

嵌入图片的体验好坏，一半取决于仓库的附件管理设置。两处值得花两分钟配置：附件默认位置——设置 → Files and links 里把附件的默认存放位置设为指定文件夹（如 附件/），之后粘贴截图、拖入图片都自动归位，仓库根目录不再散落图片文件；附件文件名——粘贴截图默认生成带时间戳的英文文件名，配合日期习惯保持即可，不建议手动重命名每张图（嵌入链接会自动更新，但成本大于收益）。

粘贴截图是最常用的图片入口：剪图后在编辑器里直接 Ctrl+V，Obsidian 自动保存到附件文件夹并生成嵌入语法。确认嵌入尺寸的意识也要养成——大图嵌入笔记前先用 |600 这类宽度约束控制显示大小，阅读体验和文件列表加载速度都会受益。批量管理层面，图片多了之后可以定期检查附件文件夹，清理已无笔记引用的孤儿文件（社区插件里有专门的孤儿附件检测工具，需要时按上一章的插件评估流程选用）。

图片是仓库里最先「失控」的资源类型：数量涨得快、单个体积大、还常被直接拖到根目录。把「统一附件文件夹 + 嵌入限宽 + 定期清理」三件事变成习惯，图片管理就永远不会成为仓库的负担。

延伸阅读：「一处维护、多处引用」的复用思想在软件工程里俯拾皆是，Claude Code 完全指南 的自动化章节提供了程序员视角的呼应；写作与编辑效率的通用技巧可看 HBuilderX 效率技巧与提效手册。

本章由 WorkBuddy 原创整理，功能行为依据 Obsidian 官方帮助文档。