vscode内置markdown预览器不渲染数学公式,因其基于精简版markdown-it且未集成katex/mathjax;需安装markdown preview enhanced(推荐ctrl+k m)或配置markdown.preview.math等设置方可正常显示。

VSCode 默认不渲染数学公式,必须启用 KaTeX 支持或换用增强预览器——否则你写的 $E=mc^2$ 会原样显示,连语法高亮都没有。
为什么内置预览(Ctrl+Shift+V)不显示公式?
VSCode 内置的 Markdown 预览器基于精简版 markdown-it,它压根不加载 KaTeX 或 MathJax;遇到 $...$ 或 $$...$$ 就当普通文本处理,既不报错也不渲染。这不是插件没装好,是设计如此。
- 即使已安装
Markdown All in One,它的公式支持仅限编辑时高亮和补全,不改变内置预览行为 -
Ctrl+Shift+V永远不会显示公式,别再反复试了 - 真正起作用的是第三方预览命令,比如
Ctrl+K M(Markdown Preview Enhanced)或Ctrl+Shift+P → Markdown: Open Preview to the Side(配合正确配置)
两种可靠方案:选一个配到底
别混搭。实测中 Markdown Preview Enhanced + Ctrl+K M 是最省心的选择;Markdown All in One + settings.json 配置则适合已有工作流、不想换插件的人。
-
推荐方案(开箱即用):装
Markdown Preview Enhanced,写公式直接用$\int_0^1 x^2 dx$(行内)或$$\nabla \cdot \mathbf{E} = \frac{\rho}{\varepsilon_0}$$(块级),然后按Ctrl+K M唤出预览 -
轻量方案(需手动配):启用
"markdown.preview.math": true,再在settings.json加上"markdown.extension.katex.macros"才能支持\begin{aligned}这类环境 - 注意:
Markdown+Math插件只提供高亮,不负责预览渲染,单独装它没用
公式写法与常见翻车点
语法本身是标准 LaTeX,但 VSCode 环境下几个细节极易导致静默失败:
- 块级公式必须独占一行:
$$开头不能有空格或文字,结尾$$同理;写成text $$E=mc^2$$ more text会失效 - 反斜杠后不能跟空格:
\ alpha(带空格)→ 渲染失败;必须是\alpha - 下标含多个字符要加花括号:
x_10显示为x₁₀,但x_100只把1当下标;应写x_{100} - 希腊字母大小写敏感:
\Sigma是大写求和符号,\sigma是小写 σ;\O不是 Ø,要用\text{\O}或\varnothing
首次预览卡住或公式模糊?检查这三处
不是网络问题就是本地配置冲突:
- 首次用
Markdown Preview Enhanced时,它会自动下载 KaTeX 和 Mermaid.js;若卡在“Loading…”可手动填国内 CDN:markdown-preview-enhanced.mathJaxUrl设为"https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/katex.min.css" - 公式字体太小?在
settings.json加"markdown-preview-enhanced.katexOptions": {"displayMode": false, "fontSize": 18} - 预览里公式位置偏移或重叠?禁用所有其他 Markdown 相关插件(尤其是
Markdown Preview Github Styling),它会干扰 KaTeX 的 CSS 注入
真正麻烦的从来不是写公式,而是搞清哪个预览器认哪套配置、哪个快捷键触发哪段逻辑。配好之后,Ctrl+K M 一按就出图,才是常态。











