Quarto表格标题内交叉引用PDF渲染失效问题求助

问题说明 #

Quarto 1.3里，表格标题内的交叉引用（比如@tbl-tab1）渲染为HTML时能正常解析，但生成PDF时不会转换成LaTeX的\ref{tbl-tab1}，原标记直接保留在标题中。对比中间文件可确认，问题出在.md到.tex的转换环节未处理标题内的引用逻辑。

最小复现代码 #

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

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

kableExtra::kable(tab)

正文引用示例：@tbl-tab1

#| label: tbl-tab2
#| tbl-cap: This table is identical to @tbl-tab1

kableExtra::kable(tab)

可行解决办法 #

办法1：使用Quarto原生交叉引用语法 #

把标题里的@tbl-tab1替换为\@ref(tbl-tab1)，这是Quarto官方支持的跨格式引用语法，HTML和PDF渲染引擎都能正确识别：

#| label: tbl-tab2
#| tbl-cap: This table is identical to \@ref(tbl-tab1)

kableExtra::kable(tab)

• 转HTML时，会自动生成带跳转功能的交叉引用；
• 转PDF时，会自动转换成LaTeX的\ref{tbl-tab1}，生成正确的引用编号。

办法2：条件渲染适配不同格式 #

如果需要更精细的控制，可借助knitr的输出判断函数，针对HTML和PDF分别指定标题内容：

#| label: tbl-tab2
#| tbl-cap: |
#|   `r if (knitr::is_html_output()) "This table is identical to @tbl-tab1" else "This table is identical to \\ref{tbl-tab1}"`

kableExtra::kable(tab)

这种方式会根据输出格式自动切换引用语法，确保两种格式下都能正常解析。

效果验证 #

使用办法1修改后，生成的.tex文件中表格标题会变为：

\caption{\label{tbl-tab2}This table is identical to \ref{tbl-tab1} }

HTML端也会正确显示可跳转的交叉引用，实现双格式完美兼容。

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