嵌入语法

链接是”指路”，嵌入是”搬运”。在 [[ ]] 前加一个感叹号 !，远方的笔记、图片、PDF 就会直接呈现在当前页面里，且与源文件保持同步。这一招，是把 Obsidian 当”看板”或”仪表盘”的关键。

嵌入整篇笔记

![[读书笔记/三体]]

整篇笔记的内容会被渲染到当前位置。源笔记改一个字，所有嵌入处自动更新。常用做法是在”主页”或”MOC（内容地图）“里嵌入若干核心笔记，构成一个总览。

不必整篇搬，只取一节：

![[时间管理#番茄工作法]]

这适合引用长文里的一小段。同样，标题改名会让嵌入失效，所以建议为”会被嵌入的章节”使用稳定、简短的标题。

![[封面.png]]
![[封面.png|300]]        只指定宽度，高度按比例缩放
![[封面.png|640x480]]    同时指定宽高

竖线 | 后的数字即像素宽度。只给宽度是最常用的做法，能避免图片被裁切，也最符合阅读节奏。

Obsidian 支持常见媒体格式，语法同样是 ![[文件名]]：

![[采访录音.mp3]]
![[演示视频.mp4]]

音频会出现一个内嵌播放器，视频则直接在笔记里播放。这让它可以兼任轻量级播客笔记库或会议纪要库。

![[论文.pdf]]
![[论文.pdf#page=3]]        打开第 3 页
![[论文.pdf#height=400]]    指定嵌入阅读器的高度（像素）

读论文时把它嵌入笔记，旁边写自己的批注，是科研党的高频用法。#page= 和 #height= 可以组合使用，比如 ![[论文.pdf#page=3&height=500]]。

先在源笔记给列表挂 ID：

- 待办 A
- 待办 B

^todo-list

再嵌入：![[项目计划#^todo-list]]。这样可以把散落在各笔记里的清单”聚合”到一篇周报里，原清单改动周报自动更新。

嵌入 Canvas 也类似：![[我的画布.canvas]]，不过嵌入的画布只显示形状，不显示卡片内的文字，要看全貌得点进去。

最强的一招——把一段搜索查询嵌入笔记，结果会实时刷新：

```sql
tag:#项目 AND status:进行中
```

凡满足条件的笔记都会列在这里。配合”主页”使用，等于给自己做了一个动态看板。需要注意，Obsidian Publish 不支持搜索嵌入，发布站点上这一块会留白。

外部图片用标准 Markdown 语法：

![示意图](https://example.com/diagram.png)
![示意图|300](https://example.com/diagram.png)

选择取舍：本地附件稳定、可离线、不依赖网络；外部图片省空间，但一旦对方删图就失效。重要内容建议落地到 Vault，临时参考可以走外链。引用网络图时若链接含空格，要用 %20 转义，或用尖括号包裹整个 URL。

把以上语法组合起来，就能搭一个”每日主页”：

# 主页

## 今日重点
![[日记/2026-07-02#今日待办]]

## 项目动态
```sql
tag:#项目 AND status:进行中

![[论文/熵减.pdf#page=5]]


打开 Obsidian 第一眼，所有动态都在。

---

`![[ ]]` 是把 Obsidian 从"笔记本"升级为"工作台"的开关。下一篇我们看 Obsidian 在标准 Markdown 之外，加了哪些独门暗器。