如何在gt表格的LaTeX输出中保留列标题换行？

要在gt生成的PDF（LaTeX输出）表格中保留列标题的换行，比如把mpg (%)拆成两行显示，你可以通过以下两种可靠方式实现：

方法一：使用LaTeX的makecell命令（推荐） #

makecell包专门用于LaTeX表格中实现单元格内换行，步骤如下：

1. 在QMD文档的YAML头部添加makecell包引用，确保LaTeX能识别该命令：

---
title: gt表格列标题换行示例
format: pdf
header-includes:
  - \usepackage{makecell}
---

2. 在gt的cols_label中，用\makecell{}包裹标题内容，使用双反斜杠\\\\转义实现换行（R字符串中需要双重转义）：

library(dplyr)
library(gt)

tbl <- mtcars |>
  select(1:4) |>
  head(5) |>
  gt()

tbl |>
  cols_label(
    mpg = "\\makecell{mpg\\\\(%)}",
    cyl = "\\makecell{cyl\\\\(%)}",
    disp = "\\makecell{disp\\\\(%)}",
    hp = "\\makecell{hp\\\\(%)}"
  )

方法二：直接使用LaTeX的\newline命令 #

如果不想额外加载makecell包，可以直接用\newline命令实现换行，同样需要双重转义：

tbl |>
  cols_label(
    mpg = "mpg\\\\newline(%)",
    cyl = "cyl\\\\newline(%)"
  )

注意：这种方式可能需要调整表格列宽才能正常触发换行，若标题内容过长建议优先用方法一。

为什么之前的方法无效？ #

• 普通的\n或Markdown换行（ \n）仅在HTML输出中生效，LaTeX环境不识别这类语法；
• 直接注入\(%)这类转义字符无法触发换行，需要用LaTeX专门的换行命令或单元格包裹命令。

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