使用gtsummary在Bookdown中实现表格自动编号及引用问题

核心问题原因 #

gtsummary的modify_caption()会直接把传入的文本作为表格标题渲染，无法识别Bookdown的(#tab:...)锚点语法，因此直接写入锚点标签会被当作普通文本显示。

推荐解决方案（代码块标签法） #

不需要在modify_caption()中添加锚点，直接给生成表格的代码块设置Bookdown表格标签即可满足所有需求：

• 给代码块添加tab:baseline标签
• modify_caption()仅填写纯标题文本
• Bookdown会自动完成编号、锚点绑定，且锚点标签不会显示

示例代码：

library(gtsummary)
# 生成患者特征表格
trial %>%
  select(trt, age, grade, response) %>%
  tbl_summary(by = trt) %>%
  modify_caption("Patient Characteristics")

效果说明：

1. 渲染后自动显示带编号的干净标题（如Table 1: Patient Characteristics）
2. 可通过@ref(tab:baseline)正常引用该表格
3. 锚点标签完全隐藏，不会出现在标题中

备选方案（分格式适配） #

如果需要更灵活的格式控制，可根据输出类型（HTML/PDF）分别设置caption：

• PDF输出（LaTeX语法）：

  modify_caption("Patient Characteristics \\label{tab:baseline}")
  

• HTML输出（HTML锚点语法）：

  modify_caption("<span id='tab:baseline'></span>Patient Characteristics")
  

此方法需要区分输出格式，不如代码块标签法简洁通用。

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