Quarto中含交叉引用的表达式PDF输出无法渲染问题

在Quarto中，通过!expr语法将包含交叉引用（如@tbl-tab1）的变量指定为表格标题时，HTML输出可正常将@tbl-tab1渲染为对应表格编号（如Table 1），但PDF输出中该交叉引用无法被解析，仅显示原始文本@tbl-tab1；而标题外的交叉引用则可正常显示。

最小可复现示例（MWE） #

tab <- data.frame(A = "A")

#| label: tbl-tab1
#| tbl-cap: cap 1

kableExtra::kable(tab)

cap <- "This table is identical to @tbl-tab1"

#| label: tbl-tab2
#| tbl-cap: !expr cap

kableExtra::kable(tab)

注：标题外的@tbl-tab1可正常显示为Table 1，但表格2的标题中@tbl-tab1在PDF输出中未被替换。

问题本质是PDF输出的交叉引用解析时机问题：使用!expr传递标题时，Quarto的交叉引用解析器尚未处理该文本，导致@语法未被替换。可通过以下两种方法解决：

方法1：用knitr::ref()手动生成引用编号 #

定义标题变量时，直接调用knitr::ref()获取目标表格的编号，替代@语法：

cap <- paste("This table is identical to Table", knitr::ref("tbl-tab1"))

表格块配置保持不变：

#| label: tbl-tab2
#| tbl-cap: !expr cap

kableExtra::kable(tab)

此方法直接生成包含正确编号的文本，确保PDF输出显示正常。

方法2：使用Quarto宏定义（适配复杂场景） #

若需复用含交叉引用的标题模板，可在文档开头定义宏：

---
title: 测试文档
format: pdf
macros:
  - name: tab-ref
    args: 1
    body: "Table @tbl-#1"
---

随后在代码块中调用宏生成标题文本：

cap <- "This table is identical to {{< tab-ref tab1 >}}"

这种方式让Quarto在渲染阶段优先处理宏中的交叉引用，保证PDF输出正常解析。

Quarto对HTML和PDF的交叉引用处理逻辑不同：HTML会在客户端动态解析交叉引用，而PDF依赖编译阶段的LaTeX引用机制。使用!expr传递的标题文本在LaTeX编译时未经过Quarto的预解析，因此需要手动触发引用解析或调整文本生成方式，确保引用编号在标题文本生成时已完成替换。

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