块级引用：精确到单行的链接语法

什么是块引用

页面链接 [[页面名]] 链接的是整个页面；块引用链接的是具体某一个块。你在写一篇文章时，可以精确引用另一篇笔记里的某一段而不是整篇复制，这就是块级引用的威力。

在 Logseq 里，块引用的写法是把 block-id 用双层圆括号（注意：不是方括号）包裹起来。下面是实际代码示例：

用反引号包裹时可以直接看到原始写法，但在正文里示例时用文字描述更安全——双层圆括号语法在 Logseq 文档中非常直观。

每个块自动分配一串类似 UUID 的唯一标识，全局不重复。这就是 block-id。

有三种方式：

拿到之后粘贴到任何地方，加上双层圆括号包裹就成了块引用。

如果你不想用那串 UUID，也可以用别名来引用块。写法和 Markdown 链接类似——方括号里写显示文字，圆括号里写块引用。

渲染后点击文字就能跳到那个块，文字本身不会显示 UUID，更易读。别名式引用适合在写作时用友好的提示文字，同时链接到具体的块。

块引用（双层圆括号包裹 block-id）和块嵌入是两回事：

选哪个？如果你只想让读者知道「这里参考了那段内容」，用引用；如果你希望那段内容就出现在当前页面、而且两边要保持同步更新，用嵌入。

假设你在做一个「学习计划」页面，需要引用「数学基础」页面里三个具体的公式：

这样「学习计划」页面里只有三个极简的块引用，而公式的完整内容仍然只在「数学基础」页面维护一份——改动一处，所有引用自动同步。每个块引用点击后会打开数学基础页面并滚动到对应的块位置。