R Markdown导出PDF时tbl_summary/gt表格换行不显示问题

在R Markdown中用gtsummary生成分组表格时，HTML输出里的标题换行能正常显示，但转PDF时换行消失，核心原因是PDF依赖LaTeX渲染，HTML的<br>或普通换行符\n在LaTeX环境中不生效。以下是可行的解决方法：

• 替换为LaTeX换行命令：在modify_header()中，把需要换行的位置换成LaTeX的\\newline（注意R字符串里要写两个反斜杠，即\\newline），PDF渲染时会识别并执行换行。
• 保持表格输出适配LaTeX：通过as_gt()转换为gt表格后，无需额外配置，gt会自动将LaTeX命令传递给PDF渲染引擎。

修改后的代码示例：

library(tidyverse)
library(gtsummary)

mtcars %>%
  select(cyl, carb) %>%
  tbl_summary(by = cyl) %>%
  # 给每个分组列的标题设置手动换行
  modify_header(
    stat_1 = "4\\newline N=11",
    stat_2 = "6\\newline N=7",
    stat_3 = "8\\newline N=14"
  ) %>%
  as_gt()

如果需要更灵活的自动换行（比如根据标题长度自动调整），可以结合gt的cols_width()和text_wrap()函数，但手动指定\\newline对分组标题的格式控制更精准。

另外，确保你的R Markdown输出设置使用支持LaTeX的PDF引擎，可在YAML头部添加：

output:
  pdf_document:
    latex_engine: xelatex

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