如何在Quarto转HTML时将MathJax默认设为SVG渲染？

• 检查_quarto.yml的配置语法与位置
  确保在format: html层级下添加MathJax的SVG配置，YAML语法对缩进要求严格，正确写法如下：

  format:
    html:
      mathjax:
        svg: true
  

  注意mathjax需与html下的其他配置项（如toc、code-fold等）保持相同缩进层级。

• 排查header-includes.html的冲突问题
  若在header文件中手动配置MathJax，可能覆盖全局配置。避免在header中重复定义渲染器为HTML-CSS，若需通过header配置SVG，应在加载MathJax脚本前添加：

  <script>
    MathJax = {
      options: {
        renderer: 'SVG'
      }
    };
  </script>
  

• 检查index.qmd的局部配置
  页面级的局部配置会优先于全局配置，打开index.qmd的开头YAML块，确认没有覆盖MathJax设置：

  ---
  # 确保此处没有如下冲突配置
  # format:
  #   html:
  #     mathjax:
  #       svg: false
  ---
  

  若存在上述配置，需修改为svg: true或删除该局部配置。

• 清除Quarto缓存并重新构建
  旧的构建缓存可能导致配置不生效，执行以下命令清理缓存后重新构建：

  quarto clean
  quarto render
  

• 验证配置是否生效
  构建完成后打开生成的HTML页面，在浏览器控制台输入以下命令，查看返回值：

  MathJax.config.options.renderer
  

  若返回'SVG'则配置生效；若返回'HTML-CSS'，需重新检查配置文件的语法、位置及加载顺序。

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