引用内容块

概述

输入 (( 后将触发内容块引用搜索，继续输入作为搜索关键字，在搜索结果中使用上下键选定后回车就可以完成内容块的引用了。建立好内容块引用后，鼠标悬浮在锚文本上后将弹出预览浮层，展现被引用的内容块（定义块）。#内容块/引用#

链接方向

• 正向链接（Forwardlink），即当前内容块使用了哪些其他内容块
• 反向链接（Backlink），即当前内容块被那些其他内容块使用了

正向链接包含在当前块的内容中，我们可以很直观的看到。反向链接需要在其他文档中搜索才能知道，而恰恰是这些信息对我们比较有价值。我们可以通过以下两种方式来帮助我们更好的掌握知识点或者发散思路：

• 关系图：浏览内容块之间的正向和反向链接关系
• 反向链接：以文本列表的方式展现当前内容块的反向链接

锚文本

锚文本即渲染引用时看到的文本，分为静态锚文本和动态锚文本：

• 静态锚文本：不会跟随定义块内容变化，即固定展现指定的内容
• 动态锚文本：跟随定义块内容变化，最大长度可在 设置 - 编辑器 - 块引动态锚文本最大长度 中设置，最长支持 5120 个字符

修改锚文本的方式如下：

• 将光标插入符移入引用元素，直接修改内容，这样会将该引用的锚文本设置为静态锚文本
• 右键单击引用元素后在弹出的菜单中修改锚文本，这样得到的锚文本也是静态锚文本
• 右键单击引用元素后在弹出的菜单中清空锚文本，这样将使用动态锚文本

在 ((​ 搜索结果列表中：

• 直接 Enter​ 或者 Click​ 将使用动态锚文本
• 按住 Ctrl+Enter​ 或者 Ctrl+Click​ 将使用静态锚文本

筛选

在 设置​ - 编辑器​ 中启用 [[ 仅搜索文档​ 后：

• 使用 ((​ 在所有类型的块中进行搜索
• 使用 [[​ 仅在文档块中进行搜索

语法

除了使用 (( 触发引用搜索外，也可以直接使用语法 ((id "锚文本"))。

• 使用 " 包裹锚文为静态锚文本
• 使用 ' 包裹锚文本为动态锚文本，会在重建索引时自动重写

直接使用语法的主要场景是通过外部工具或者 API 建立引用，大部分情况下我们主要还是直接使用 ((​ 触发引用搜索来建立引用。