如何在Sphinx文档中配置MathJax physics包以正确渲染公式？

要让Sphinx全局支持\vb命令（无需在每个math块添加\require{physics}），你需要在conf.py中同时配置MathJax的路径和扩展加载参数，具体步骤如下：

• 配置MathJax 3的全局扩展
  在conf.py中添加以下配置：

  mathjax_path = "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"
  mathjax_config = r'''
  MathJax.config = {
    tex: {
      packages: {'[+]': ['physics']},
    }
  };
  '''
  

  这段配置会告诉MathJax 3加载physics包，从而全局识别\vb等该包提供的命令，包括autodoc处理的文档字符串中的公式。

• 重新构建文档
  执行make html（或对应平台的构建命令）重新生成文档，此时所有使用\vb的公式应该会正确渲染成向量格式，无需额外添加\require{physics}。

• 排查未生效的原因
  你之前仅设置mathjax_path只是加载了MathJax核心库，但未指定要加载physics扩展，因此\vb命令无法被识别。必须通过mathjax_config明确配置加载该扩展才能全局生效。

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