使用Quarto生成PDF时，表格列标题无法换行的问题求助

你遇到的核心问题是：gt在PDF渲染场景下不支持HTML的<br>标签，需要改用LaTeX的换行语法来实现列标题拆分。以下是可行的解决方法：

方法一：使用LaTeX换行命令（推荐） #

直接在列标题中使用LaTeX的\\newline命令，配合md()函数，同时注意在R字符串里要对反斜杠做转义（写两个反斜杠）：

修改代码中cols_label部分：

cols_label(
  Sepal.Length = md("Sepal\\\\newline Length")
)

Quarto渲染PDF时，gt会把这段markdown转换成对应的LaTeX代码，\\newline会被解析为换行，最终实现"Sepal"和"Length"分两行显示。

你也可以用\\linebreak替代\\newline，效果基本一致：

Sepal.Length = md("Sepal\\\\linebreak Length")

方法二：关闭HTML标签检查警告（可选） #

如果只是不想看到HTML标签被移除的警告，可以在加载包后添加一行代码关闭检查：

options(gt.html_tag_check = FALSE)

但要注意，这只是消除警告，HTML的<br>标签依然会被移除，无法实现换行，因此更推荐用方法一解决根本问题。

完整示例代码 #

---
title: "Unbreakable Line"
format: pdf
editor: visual
---

#| label: load-packages
#| include: false

library(tidyverse)
library(magrittr)
library(tinytex)
library(gt)

# 可选：关闭警告（非必须，建议用方法一实现换行）
# options(gt.html_tag_check = FALSE)

iris %>% 
  head(10) %>% 
  gt() %>% 
  cols_label(
    Sepal.Length = md("Sepal\\\\newline Length")
  )

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