如何在PDF输出中使用gt()处理跨页长表格？

核心原因 #

gt默认生成的LaTeX表格使用tabular环境，该环境不支持跨页，即便加载longtable包也不会自动切换环境，因此需要手动修改输出的LaTeX代码，强制使用longtable实现分页。

解决方案 #

在R代码中生成gt表格后，将其转换为LaTeX代码，替换表格环境为longtable并添加表头重复设置，最后直接输出处理后的LaTeX代码：

library(tidyverse)
library(gt)
library(knitr)

# 生成示例数据
tbl <- tibble(
    variable = paste0("var", 1:80),
    value = runif(80),
    test = runif(80)
) %>% gt()

# 转换并修改LaTeX代码
latex_code <- as_latex(tbl) %>%
  as.character() %>%
  # 替换tabular环境为longtable
  str_replace("\\\\begin\\{tabular\\}", "\\\\begin\\{longtable\\}") %>%
  str_replace("\\\\end\\{tabular\\}", "\\\\end\\{longtable\\}") %>%
  # 添加表头重复规则，确保每页顶部显示表头
  str_replace("\\\\toprule", "\\\\toprule\n\\\\endhead")

# 直接输出处理后的LaTeX代码
asis_output(latex_code)

注意事项 #

1. 确保Quarto的YAML预导言已包含longtable包（你的示例中已配置）；
2. 若表格有复杂样式（如颜色、单元格合并），需额外调整LaTeX代码适配longtable；
3. str_replace依赖stringr包（已包含在tidyverse中）。

gt-Quarto-LaTeX实用资源 #

• gt官方文档LaTeX输出章节：详细讲解自定义LaTeX输出格式的方法，包括环境设置、样式调整、字体配置等；
• Quarto官方gt集成指南：介绍在Quarto文档中使用gt生成PDF表格的最佳实践，涵盖分页、跨文档样式统一等内容；
• gt GitHub仓库示例库：包含大量针对LaTeX输出的示例代码，可参考解决各类表格格式化问题。

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