Quarto交叉引用：文本变更时如何实现持久化标题引用？

核心思路 #

利用Quarto内置的交叉引用格式扩展功能，通过显式ID+格式后缀实现标题自动同步的引用，彻底解决标题修改后引用失效的问题。

具体实现步骤 #

1. 给章节/图表设置唯一显式ID

所有需要引用的元素必须提前设置固定的英文ID（避免中文ID编译异常），格式如下：

• 章节：## 我的精彩章节 {#sec-awesome}
• 图表：![数据可视化示例](fig/data.png){#fig-visual}

2. 两种引用格式的实现

（1）编号式引用（如“如第3.1节所述”）

直接使用显式ID调用，Quarto会自动匹配章节/图表的编号，配合全局配置可实现规范的中文格式：

• 引用语法：如@sec-awesome所述
• 全局配置（在_quarto.yml中添加）：

crossref:
  sections:
    title: "第"
    suffix: "节"
  figures:
    title: "图"
    suffix: ""

编译后自动输出：如第3.1节所述

（2）标题式引用（自动同步标题，如“如‘我的精彩章节’所述”）

在显式ID后添加:title后缀，直接调用元素的标题文本，标题修改后引用会自动同步：

• 引用语法：如‘@sec-awesome:title’所述
• 效果：当章节标题修改为“进阶技巧详解”时，编译后自动变为如‘进阶技巧详解’所述

（可选）编号+标题组合引用

如果需要同时显示编号和标题，直接拼接两种引用即可：

• 引用语法：如@sec-awesome‘@sec-awesome:title’所述
• 编译后输出：如第3.1节‘我的精彩章节’所述

注意事项 #

• 所有显式ID必须唯一，避免重复导致引用混乱
• ID建议使用英文小写+连字符的格式（如#sec-data-processing），不要用空格或特殊字符
• 修改标题后只需重新编译文档，引用会自动同步最新标题

内容的提问来源于stack exchange，提问作者SamR