Quarto渲染Word时gt表格标题不显示的解决咨询

问题根源 #

gt包的tab_caption()原生适配HTML/LaTeX输出，直接渲染docx时无法被Quarto识别；而Quarto的tbl-cap参数需要表格对象支持其交叉引用协议，gt默认输出不兼容该协议，导致标题丢失。

可行解决方案 #

方案1：转原始HTML配合Quarto表格块 #

将gt表格转为原始HTML，让Quarto的表格标题参数正常生效：

#| tbl-cap: "This is a working caption"
library(gt)
gt(mtcars) |> 
  as_raw_html()

方案2：启用gt的Quarto交叉引用支持 #

gt v0.9.0及以上版本支持Quarto交叉引用，只需在YAML配置中开启对应选项，之后两种标题设置方式都能正常工作：

1. 修改YAML头部：

---
title: "test"
format: docx
gt: quarto
---

2. 使用tab_caption()：

library(gt)
gt(mtcars) |> 
  tab_caption("This is a caption with quarto support")

3. 或使用tbl-cap参数：

#| tbl-cap: "This is also a working caption"
library(gt)
gt(mtcars)

验证提示 #

• 检查gt版本：运行packageVersion("gt")确认≥0.9.0，版本过低则执行install.packages("gt")更新。
• 渲染后docx的表格标题会自动匹配Word内置的表格标题样式，和图表标题格式统一。

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