Quarto + Typst 文档目录缩进设置失效问题求助

• 确认Quarto版本兼容性
  仅Quarto 1.4及以上版本正式支持Typst输出的toc-indent参数。终端执行quarto --version检查版本，低于1.4请升级至最新稳定版。

• 校验YAML配置层级
  确保toc-indent放在format.typst层级下，错误层级会被忽略，正确配置示例：

  ---
  title: "文档标题"
  format:
    typst:
      toc: true
      toc-indent: 1.5em
  ---
  

  避免将参数放在根YAML层级或其他无关配置块中。

• 检查本地Typst版本
  Quarto优先调用系统环境的Typst，若本地Typst版本低于0.10.0，可能不兼容该缩进参数。终端执行typst --version检查，过低则升级Typst。

• 排除自定义模板干扰
  若文档指定了自定义Typst模板（通过template参数），模板可能硬编码了目录缩进样式，覆盖YAML配置。先注释自定义模板，用默认模板测试。

• 用最小示例复现验证
  创建极简测试文档，排除其他内容/插件的干扰：

  ---
  title: "缩进测试"
  format:
    typst:
      toc: true
      toc-indent: 3em
  ---
  
  # 一级标题
  测试内容
  
  ## 二级标题
  测试内容
  
  ### 三级标题
  测试内容
  

  编译后若缩进生效，说明原文档存在配置冲突。

• 查看渲染日志定位问题
  执行quarto render your-document.qmd --log-level debug，查看日志中是否有toc-indent参数被忽略的警告/错误，以此定位具体问题。

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