Quarto渲染HTML文档时如何显示可切换的大纲？

你的问题出在YAML配置的层级结构错误，导致toc: true的设置没有被正确加载。你当前的配置把format嵌套在了quarto::quarto_html下，这不符合Quarto的配置规范。

正确的YAML配置 #

---
title: "你的文档标题"
output:
  html:
    toc: true
    self-contained: true
---

或者如果你明确指定quarto::quarto_html格式，正确的结构应该是：

---
title: "你的文档标题"
output:
  quarto::quarto_html:
    toc: true
    self-contained: true
---

配置说明 #

• toc: true：启用HTML页面的目录（大纲）功能
• self-contained: true：将所有外部资源（样式、脚本）打包进单个HTML文件，方便分享

额外优化选项（可选） #

如果需要更灵活的大纲设置，可以添加以下配置：

• toc-depth: 3：指定大纲显示的标题层级（比如显示到三级标题）
• toc_float: true：让大纲悬浮在页面侧边，滚动时保持可见，并且支持折叠/展开

  output:
    html:
      toc: true
      toc_float: true
      toc_depth: 3
      self-contained: true
  

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