huxtable在bookdown::html_document2中不显示标题文本的原因及解决方法

huxtable 默认不会自动识别 knitr 代码块的 tab.cap 选项来生成表格标题，而 flextable 和基础 R 绘图的渲染逻辑与 huxtable 不同，它们能直接读取这类块选项并显示标题。

有两种可行的解决方式：

方式一：使用 huxtable 内置函数设置标题 #

通过 set_caption() 函数为表格显式添加标题，bookdown 会自动识别并渲染该标题：

huxtable::hux(head(iris)) %>% 
  huxtable::set_caption("My cool huxtable")

方式二：启用 huxtable 的 knitr 标题读取功能 #

在代码块选项中添加 huxtable.knit_print_caption = TRUE，让 huxtable 读取 tab.cap 的值作为标题：

huxtable::hux(head(iris))

两种方式都能让 huxtable 的标题正常显示，且 bookdown 会自动处理表格的编号逻辑。

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