使用rmarkdown::render渲染bookdown::html_document2时toc缺失求助

问题原因 #

当你通过rmarkdown::render('test.Rmd', output_format = "html_document2")渲染时，output_format参数直接使用格式名称会调用该格式的默认配置，而bookdown::html_document2默认不开启目录（toc），因此导致目录缺失。而RStudio的Knit按钮会读取Rmd文件YAML头部的配置参数进行渲染，所以能正常显示目录。

两种解决方案 #

方案1：让render自动读取YAML配置 #

直接调用render时不指定output_format，它会自动读取Rmd文件头部的YAML配置，包括你设置的toc: true等参数：

rmarkdown::render('test.Rmd')

方案2：在render中显式传递格式参数 #

如果需要在代码中指定output_format，需将目录等配置参数直接传入bookdown::html_document2()函数：

rmarkdown::render(
  'test.Rmd',
  output_format = bookdown::html_document2(
    toc = TRUE,
    toc_float = TRUE,
    code_folding = "show"
  )
)

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