R Markdown设置toc: true报错提示toc对象未找到该如何解决

报错根因 #

报错是YAML头部语法不规范导致的，存在两处语法错误：

• html_document下的子参数toc没有做层级缩进，R解析时将toc识别为独立变量而非输出参数，因此抛出object 'toc' not found错误
• toc:后没有加空格，YAML语法要求键名和值之间的冒号后必须跟空格，否则会被识别为无效键名

正确配置示例 #

将YAML头部调整为以下格式即可正常渲染带目录的HTML文档：

---
title: "XXX Report"
output:
  html_document:
    toc: true
---

可选拓展配置 #

如果需要实现侧边悬浮目录、调整目录显示的标题层级，可以追加以下参数：

---
title: "XXX Report"
output:
  html_document:
    toc: true
    toc_float: true
    toc_depth: 3
---

toc_depth: 3代表目录最多显示到三级标题，可根据需求调整数值。

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