块嵌入 vs 块引用：同步复制还是跳转链接
核心区别
| 特性 | 块引用（双层圆括号 block-id） | 块嵌入 |
|---|---|---|
| 视觉 | 可点击链接 | 完整显示源块内容 |
| 数据 | 单向跳转 | 双向同步 |
| 维护 | 只需改源块 | 改任意一处另一处自动更新 |
| 适用 | 提示「请看这段」 | 需要在多处同时看到同一份内容 |
| 反向引用 | 会被收录 | 会被收录 |
什么时候用引用
- 你只想让读者知道「这里参考了那段」，不想搬过来
- 源块的内容很长，嵌入会让当前页面太臃肿
- 你不确定源块以后会不会频繁变动，或者你希望读者到源页面看完整上下文
什么时候用嵌入
- 你需要在当前页面直接看到那段内容，不想让读者跳转
- 那段内容是你当前论证的关键支撑，不放在眼前容易断章取义
- 你在不同页面里需要实时同步同一段任务描述、公式定义、常用模板
嵌入的创建方式
最简单的方式：复制 block-id 后加上 /embed/ 前缀。或者在源块上右键选择「Embed block」然后粘贴到目标位置。
也可以直接在右侧面板的块引用列表里点击「嵌入」按钮，把引用自动升级为嵌入。
嵌入与页面嵌入
Logseq 支持三种嵌入：
- 块嵌入 — 嵌入单个块（本节讲的）
- 页面嵌入 — 嵌入整个页面，语法是
{{embed [[页面名]]}} - 白板嵌入 — 在白板画布上嵌入块或页面（见 04-白板画布）
页面嵌入适合当某个页面的内容整体作为另一个页面的子模块时用；块嵌入粒度更细。
嵌入的注意事项
- 嵌入内容不可独立编辑——所有修改都会回写到源块。如果你需要一份可以独立修改的副本，复制粘贴普通文本即可
- 嵌入块上会显示一个小图标，鼠标悬浮可以看到源块位置，也可以点击跳转到源头
- 如果源块被删除了，嵌入会显示为「内容已删除」的提示，不会丢失你的页面结构
- 嵌入的源块可以在任何页面里，不限于当前图谱
一个常见场景：任务看板
假设你有一个「本周重点」页面，列出了 5 个任务。你在「周一计划」「周二计划」「周三计划」里都需要看到这 5 个任务的当前状态。
把每个任务块嵌入到每天的计划里，这样任务状态变化时（从 TODO 变成 DONE），所有页面上的那份都会自动更新——你不需要每天手动同步三遍。