如何在Sphinx-Gallery中正确渲染SymPy数学表达式输出？

方法一：利用LaTeX + MathJax渲染（推荐） #

Sphinx原生支持MathJax渲染LaTeX公式，我们可以给SymPy的基础表达式类打猴子补丁，让表达式输出含LaTeX的HTML结构，从而被MathJax识别并渲染：

from sympy import latex
from sympy.core.basic import Basic

def sympy_expr_to_html(expr):
    # 用MathJax兼容的格式包裹LaTeX代码
    return f'<span class="math display">\\[{latex(expr)}\\]</span>'

# 给所有SymPy基础表达式类添加HTML表示方法
Basic._repr_html_ = sympy_expr_to_html

# 后续SymPy代码
from sympy import symbols, Symbol, Eq, sqrt
x, y = symbols("x y")
expr = Eq(Symbol(r"\dot{x}"), x*y**2 - sqrt(x)/y)
expr

同时需要在Sphinx的conf.py中确保启用MathJax扩展：

extensions = [
    'sphinx.ext.mathjax',
    'sphinx_gallery.gen_gallery',
    # 其他你需要的扩展
]

# 可选：配置MathJax CDN路径，也可使用Sphinx默认路径
mathjax_path = 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js'

方法二：生成Presentation MathML #

你之前的问题根源在于使用了SymPy默认的mathml函数，它输出的是Content MathML（包含<apply>节点），这种格式侧重数学语义结构而非可视化排版；而浏览器、MathJax更兼容的是侧重排版的Presentation MathML。需要改用SymPy的PresentationPrinter生成正确的MathML：

from sympy.printing.mathml.presentation import PresentationPrinter
from sympy.core.basic import Basic

def sympy_to_presentation_mathml(expr):
    printer = PresentationPrinter()
    mathml_code = printer.doprint(expr)
    return f'<math xmlns="http://www.w3.org/1998/Math/MathML" display="block">{mathml_code}</math>'

Basic._repr_html_ = sympy_to_presentation_mathml

# 后续SymPy代码
from sympy import symbols, Symbol, Eq, sqrt
x, y = symbols("x y")
expr = Eq(Symbol(r"\dot{x}"), x*y**2 - sqrt(x)/y)
expr

错误原因说明 #

SymPy默认的sympy.printing.mathml.mathml函数生成的Content MathML，核心是描述数学表达式的逻辑关系（比如用<apply>表示运算动作），而非定义排版样式。但浏览器和Sphinx的渲染引擎仅支持用于可视化呈现的Presentation MathML，因此会触发"Unknown node type 'apply'"的错误。

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