[Markdown]MathJax支持
reStructuredText MathJax
Sphinx教程介绍的是在配置工程时加入mathjax选项就可以将公式编辑成图片
我用markdown写文档时，在本地生成的文档中无法正确显示公式，但是在首页（index.rst）中加入一句
:math:`\sigma_{1}`
就好了。母鸡？
不过在readthedocs中可以正常显示的
\[
\begin{bmatrix} 1& 2& 3\ 4& 5& 6\ 7& 8& 9 \end{bmatrix}\Rightarrow \begin{bmatrix} 3& 2& 1\ 6& 5& 4\ 9& 8& 7 \end{bmatrix}\Rightarrow \begin{bmatrix} 9& 8& 7\ 6& 5& 4\ 3& 2& 1 \end{bmatrix}
\]
Markdown MathJax
在sphinx上使用markdown编写数学公式时，扩展mathjax的效果很差
比如行间公式$...$就无法使用，得用\\(...)\\
另外对于另起一行插入数学公式$$...$$，如果是单行公式能够支持，但是对于多行公式无法渲染
Issue
Sphinx工程目前还没有完全支持markdown，尤其是对于数学公式。比如在Markdown中，行内数学符号用$...$，行外数学符号用$$...$$，但是在Sphinx工程中，无法实现行内数学符号效果，行外数学符号也只支持单行
所以如果有涉及数学公式的文章，还是使用其他方法好一点。在github上提了一个bug：Sphinx Markdown MathJax doesn't work correctly #5957