GitHub上Mathjax无法正确渲染pmatrix矩阵的问题排查
2026-7-7
解决MathJax矩阵导致Markdown TOC失效及GitHub渲染异常问题
问题根源
- TOC失效原因：你使用了
```math包裹$$块的双重嵌套语法，Markdown All in One的TOC生成器会被这种非标准结构干扰，中断标题扫描逻辑。 - GitHub渲染异常原因：GitHub采用KaTeX渲染数学公式，不支持
```math代码块包裹LaTeX的写法，仅认可直接用$$包裹的块级公式格式。
解决方案
方案1：移除外层```math包裹，改用标准$$块
将原代码改为纯
$$
PE_{\text{input}} =
\begin{pmatrix}
0 & 1 & 0 & 1 \
\sin\left(\frac{1}{10000^0}\right) & \cos\left(\frac{1}{10000^{0.5}}\right) & \sin\left(\frac{1}{10000^2}\right) & \cos\left(\frac{1}{10000^{2.5}}\right) \
\sin\left(\frac{2}{10000^0}\right) & \cos\left(\frac{2}{10000^{0.5}}\right) & \sin\left(\frac{2}{10000^2}\right) & \cos\left(\frac{2}{10000^{2.5}}\right)
\end{pmatrix}
$$包裹的LaTeX块，这是GitHub和多数Markdown编辑器兼容的标准写法，同时能修复TOC失效问题：$$
PE_{\text{input}} =
\begin{pmatrix}
0 & 1 & 0 & 1 \
\sin\left(\frac{1}{10000^0}\right) & \cos\left(\frac{1}{10000^{0.5}}\right) & \sin\left(\frac{1}{10000^2}\right) & \cos\left(\frac{1}{10000^{2.5}}\right) \
\sin\left(\frac{2}{10000^0}\right) & \cos\left(\frac{2}{10000^{0.5}}\right) & \sin\left(\frac{2}{10000^2}\right) & \cos\left(\frac{2}{10000^{2.5}}\right)
\end{pmatrix}
\begin{pmatrix}
0 & 1 & 0 & 1 \
0.8415 & 0.99995 & 0.0001 & 1 \
0.9093 & 0.9998 & 0.0002 & 1
\end{pmatrix}
$$
方案2：简化LaTeX语法，减少嵌套复杂度
如果方案1仍有问题，可去掉不必要的
$$
PE_{\text{input}} =
\begin{pmatrix}
0 & 1 & 0 & 1 \
\sin(1/10000^0) & \cos(1/10000^{0.5}) & \sin(1/10000^2) & \cos(1/10000^{2.5}) \
\sin(2/10000^0) & \cos(2/10000^{0.5}) & \sin(2/10000^2) & \cos(2/10000^{2.5})
\end{pmatrix}
\left(/\right)自适应括号（简单分数无需自适应），减少特殊字符数量，降低对TOC解析的干扰：$$
PE_{\text{input}} =
\begin{pmatrix}
0 & 1 & 0 & 1 \
\sin(1/10000^0) & \cos(1/10000^{0.5}) & \sin(1/10000^2) & \cos(1/10000^{2.5}) \
\sin(2/10000^0) & \cos(2/10000^{0.5}) & \sin(2/10000^2) & \cos(2/10000^{2.5})
\end{pmatrix}
\begin{pmatrix}
0 & 1 & 0 & 1 \
0.8415 & 0.99995 & 0.0001 & 1 \
0.9093 & 0.9998 & 0.0002 & 1
\end{pmatrix}
$$
方案3：手动编写TOC（终极兜底）
若插件自动TOC仍无法恢复，可手动编写目录，用Markdown锚点链接指向对应标题，彻底绕过插件解析问题：
内容的提问来源于stack exchange，提问作者Grant Curell
相关产品推荐
相关产品推荐
