Quarto Markdown渲染时gt表格隐藏列标题异常显示

针对你遇到的gt表格在R代码块显示正常，但渲染PDF时隐藏的列标题重现、单元格加粗样式丢失的问题，可按以下方案解决：

核心问题原因 #

gt包生成PDF时依赖LaTeX渲染，column_labels.hidden = TRUE参数在部分LaTeX输出场景下兼容性不佳，同时单元格样式的传递需要确保LaTeX能正确识别。

具体解决方案 #

1. 替换列标题隐藏方式 #

放弃column_labels.hidden = TRUE，改用cols_label()将name和value列的标签设为空字符串，再通过tab_options()隐藏列标题的边框与背景，彻底隐藏标题区域：

library(gt)
library(tidyr)
library(dplyr)

# 示例数据
df <- tibble(
  id = 1:3,
  var1 = c(10, 20, 30),
  var2 = c(15, 25, 35)
) %>%
  pivot_longer(cols = -id, names_to = "name", values_to = "value")

# 构建gt表格
df %>%
  gt() %>%
  # 将name和value列标签设为空
  cols_label(
    name = "",
    value = ""
  ) %>%
  # 隐藏列标题的边框、背景，彻底隐藏标题区域
  tab_options(
    column_labels.border.top.width = px(0),
    column_labels.border.bottom.width = px(0),
    column_labels.background.color = "transparent"
  ) %>%
  # 为指定单元格设置加粗样式（示例：id=1的value单元格）
  tab_style(
    style = cell_text(weight = "bold"),
    locations = cells_body(
      columns = value,
      rows = id == 1
    )
  )

2. 配置兼容的PDF引擎 #

在Quarto文档的YAML头部指定xelatex或lualatex作为PDF引擎，避免默认引擎的渲染兼容问题：

---
title: "GT Table PDF Test"
format:
  pdf:
    engine: xelatex
---

3. 更新依赖包 #

确保gt、quarto、tidyr等包为最新版本，旧版本可能存在PDF渲染的已知bug：

install.packages(c("gt", "tidyr", "dplyr"))

验证效果 #

运行上述代码并渲染PDF后，name和value的列标题会被彻底隐藏，指定单元格的加粗样式也能正常保留。

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