我明白你现在遇到的困扰：已经在Sphinx里启用了MathJax扩展，LaTeX公式渲染一切正常，但换成MathML后，页面直接显示原始的XML代码而不是渲染好的公式——虽然MathJax官方确实宣称支持MathML。这其实是因为Sphinx默认的配置和处理逻辑没有针对MathML做适配，下面我给你一步步解决的方案：

1. 调整MathJax配置，启用MathML支持 #

默认情况下，Sphinx集成的MathJax可能没有加载处理MathML的专用扩展。你需要在conf.py中添加自定义配置，确保MathJax能识别并转译MathML：

打开你的conf.py，添加或修改以下内容：

mathjax_config = '''
MathJax.Hub.Config({
  extensions: ["mml2jax.js"],
  jax: ["input/MathML", "output/CommonHTML"]
});
'''

这段配置告诉MathJax加载mml2jax.js扩展（专门负责捕获并处理MathML标签），同时将MathML设为合法的输入格式。

2. 在RST文件中正确嵌入MathML #

不能直接在RST里裸写MathML代码——Sphinx的RST解析器会把它当成普通XML文本处理，不会传递给MathJax。你需要用raw指令将MathML标记为原生HTML内容，这样Sphinx会直接输出这段代码，让MathJax能捕获到它：

示例代码如下：

.. raw:: html

   <math xmlns="http://www.w3.org/1998/Math/MathML">
     <mrow>
       <msup><mi>x</mi><mn>2</mn></msup>
       <mo>+</mo>
       <msup><mi>y</mi><mn>2</mn></msup>
       <mo>=</mo>
       <msup><mi>r</mi><mn>2</mn></msup>
     </mrow>
   </math>

⚠️ 注意：MathML标签必须包含正确的命名空间xmlns="http://www.w3.org/1998/Math/MathML"，否则MathJax无法识别它。

3. 重新构建文档验证效果 #

修改完配置和RST内容后，重新执行Sphinx的构建命令（比如make html），然后打开生成的HTML页面，你应该能看到MathML被正确渲染成公式了。

为什么LaTeX能正常工作？ #

这是因为Sphinx的MathJax扩展默认会自动处理RST中的:math:指令或者$$包裹的LaTeX代码，将它们转换成MathJax能识别的格式；但对于MathML，Sphinx没有内置的自动处理逻辑，所以需要我们手动通过raw指令和MathJax扩展配置来实现支持。

内容的提问来源于stack exchange，提问作者Ralph B.