Quarto生成docx时带交叉引用标签的flextable表头不重复问题

要同时实现docx文档中flextable的表头跨页重复、表格标题与交叉引用功能，按以下方式调整代码即可：

关键操作 #

• 显式调用flextable的set_table_properties()方法，强制开启表头重复：set_table_properties(repeat_header = TRUE)
• 代码块中使用tbl-cap属性定义表格标题（而非fig-cap，fig-cap是为图片设计的属性），保留label标签用于交叉引用

完整示例代码 #

---
title: "My document"
format:
  docx:
    colorlinks: true
---

无标题的表格（自动重复表头）：
```r
flextable::flextable(iris)

带标题、支持交叉引用且表头跨页重复的表格：

#| label: tbl-test
#| tbl-cap: Table caption
library(flextable)

flextable(iris) %>%
  set_table_properties(layout = "autofit", repeat_header = TRUE)

原理说明 #

添加交叉引用标签后，Quarto会对表格进行包装处理，默认会覆盖flextable的自动表头重复逻辑。通过显式设置repeat_header = TRUE，可以强制flextable保留跨页表头重复的特性，同时配合label和tbl-cap实现标题与交叉引用功能。

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