Jupyter Notebook 里 LaTeX 公式不渲染，常见原因通常就这几类：单元格没有切到 Markdown 模式、MathJax 的 CDN 加载失败，或者公式里混入了全角符号。

如果是在离线环境下，还可以通过 nbconvert 导出 HTML、本地部署 MathJax，或者直接用 IPython.display.Latex 来绕开这个问题。

MathJax 默认已启用，无需额外配置。只要 Jupyter Notebook 启动时能联网加载 CDN 资源，$$ 和 $ 包裹的 LaTeX 就能正常渲染。

但现实中常见的问题是“公式不显示”。这通常不是配置缺失，而是环境连通性或单元格类型使用错误。

为什么公式不渲染？先查这三件事

常见现象是：写好 $$E = mc^2$$，运行后只看到原样字符串，没有变成公式。

• 单元格没设成 Markdown 模式。如果还是 Code 模式，公式不会渲染。这是最高频错误。可按 Esc 退出编辑，再按 M 切换；也可以从菜单栏 Cell → Cell Type → Markdown 设置。
• 浏览器拦截了 https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js。可打开开发者工具（F12），查看 Console 是否报 Failed to load resource。离线或内网环境下，这类问题很常见。
• 公式里用了中文引号、全角符号，或粘贴时带入了隐藏控制字符。比如把 $$ 粘成了 $$，看起来一样，实际却不是同一种符号。最稳妥的方法是手动重敲一遍。

离线环境怎么让 LaTeX 正常工作

当无法访问 CDN，比如公司内网或无外网笔记本环境，MathJax 加载失败后，公式就可能完全空白。

• 方案一：用 jupyter nbconvert --to html --no-input notebook.ipynb 导出 HTML。这样可以把 MathJax 打包进本地文件。需要注意的是，PDF 导出通常要提前安装完整版 TeX 环境，但 HTML 不需要。
• 方案二：手动部署本地 MathJax。下载 MathJax v3.x，解压到 ~/.jupyter/custom/ 下，再在 custom.js 里加一行：window.MathJax = {loader: {source: {'[tex]/ams': 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/input/tex/extensions/ams.js'}}};。不过更推荐改用 mathjax-config.js 注入路径，避免覆盖默认配置。
• 方案三：临时绕过。使用 IPython.display.Latex 强制渲染，例如：from IPython.display import Latex; Latex(r"frac{a}{b}")。它走的是内核→前端的富文本通道，不依赖页面级 MathJax。

sympy.display() 和纯 Markdown 公式有什么区别

本质上，它们都是依靠 MathJax 渲染。不同点在于触发时机和可控性。

• display(expr) 是把 Python 表达式实时转成 LaTeX 字符串，再发送到前端。适合自动化展示推导过程。但前提是 expr 必须是 sympy 对象，普通字符串或 NumPy 数组会报错。
• Markdown 中写 $$int_0^1 x^2 dx$$ 属于静态文本，完全由前端解析，不经过 Python 内核。因此通常更快、更稳定，也支持多行对齐、编号等高级 LaTeX 功能。
• 如果混用，在同一个 cell 里既执行 display()，又写 Markdown 公式，可能因为执行顺序不同导致排版错位。更建议把逻辑分开：推导过程用 sympy，最终结论用 Markdown 展示。

排查重点总结

真正麻烦的不是“怎么配”，而是“配好了却以为没配”。

公式渲染发生在浏览器端，和 Python 内核无关，也不会写日志。只要单元格类型正确、符号使用半角、网络连通正常，公式就应该显示。

如果仍然没有显示，90% 是前面那三项里有一项没有检查到位。

《夸克》非常好用的免费AI浏览器

下载APP查看