如何在Quarto中交叉引用kable生成的表格？

问题根源 #

Quarto需要明确识别表格为可交叉引用对象，仅设置label和tbl-cap不足以让系统正确解析kable生成的表格，导致引用失效。

可行修复方案 #

1. 借助kableExtra增强表格识别（PDF格式适配） #

添加kable_styling确保Quarto捕获引用信息，代码如下：

#| label: out
#| tbl-cap: 自定义表格标题
library(knitr)
library(kableExtra)
kable(mtcars) %>%
  kable_styling(latex_options = "hold_position")

2. 调整代码块选项（无需额外包） #

添加tbl-cap-location选项，明确表格标题位置，帮助Quarto识别：

#| label: out
#| tbl-cap: 自定义表格标题
#| tbl-cap-location: top
library(knitr)
kable(mtcars)

3. 检查渲染方式 #

• 确保使用quarto render命令生成PDF，而非仅依赖可视化编辑器预览
• 确认文档头部format: pdf配置无误

修改后，@out会自动替换为对应表格的编号（如「表1」），实现正常交叉引用。

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