vscode内置markdown预览仅支持基础渲染,不支持实时刷新、数学公式和mermaid图表;需装插件:markdown all in one增强编辑但不接管预览,mpe则提供全功能预览但会替代内置预览。

VSCode 内置 Markdown 预览够用,但想支持数学公式、Mermaid 图表、实时刷新,必须装插件——不是“选不选”,而是“选哪个、怎么配”。
内置预览能做什么、不能做什么
按 Ctrl+Shift+V(Win/Linux)或 Cmd+Shift+V(macOS)就能调出侧边预览,但它只在文件保存后刷新,不响应编辑中的实时变化;$$E = mc^2$$ 这类行间公式默认不渲染;mermaid 代码块直接当纯文本显示。常见错误现象包括:预览空白、右下角状态栏显示“Plain Text”而非“Markdown”、公式显示为原始 LaTeX 字符串。
- 确认文件后缀是
.md,且右下角语言模式已设为Markdown - 检查设置中
markdown.preview.enabled是否为true(不要手动关掉) - 若用的是多根工作区,预览路径解析以**当前打开的文件夹根目录**为准,
要确保img/相对于该根目录存在
Markdown All in One:编辑增强型插件
它不接管预览,只专注提升写作效率,和内置预览配合最稳。安装后,Ctrl+B 加粗、Ctrl+Shift+P → Markdown: Create Table of Contents 自动生成目录、Alt+C 插入代码块都立刻可用。数学公式支持依赖配置项,不是自动开箱即用。
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力,其中最引人注目的是新增 Copilot CLI 远程控制功能,允许开发者通过手机或网页远程监控和接管 AI 会话 。同时,为了提高 AI 的运行性价比,新版本优化了令牌缓存策略以降低成本 。此外,1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- 必须开启
markdown.extension.math.enabled(设为true) - 必须开启
markdown.preview.enableScripts(否则 MathJax 不加载) - 推荐加一行:
"markdown.preview.preferredMdEngine": "github",避免解析歧义 - 它不处理 Mermaid,也不提供导出 PDF 功能,别指望它解决图表或交付问题
Markdown Preview Enhanced(MPE):全功能预览替代方案
这是目前唯一稳定支持实时热更新、KaTeX/MathJax 公式、Mermaid 渲染、Reveal.js 幻灯片的插件。但它会完全接管预览逻辑,和内置预览冲突——装了 MPE 后,Ctrl+Shift+V 失效,要用 Ctrl+K V。
- 首次启用需重启 VSCode,打开
.md文件时会提示初始化,点Yes - 公式生效前提:设置
markdown-preview-enhanced.enableExtendedSyntax为true - Mermaid 渲染需额外安装 CLI:
npm install -g mermaid-cli,再配置markdown-preview-enhanced.mermaidPath - 性能开销比内置预览高,大文档滚动可能卡顿,不建议同时启用其他 WebView 类预览插件
别踩这些坑
插件装多了反而坏事。比如同时启用 MPE 和 Markdown+Math,公式可能重复加载导致错乱;禁用 markdown.preview.enabled 又没卸载 MPE,预览窗口直接报 Cannot read property 'webview' of undefined;Mermaid 路径配错,图表区域只显示“Loading…”。
- 优先用
Ctrl+Shift+P→Markdown: Toggle Preview触发预览,比快捷键更可靠 - 本地图片路径错乱,90% 是因为工作区根目录没设对,不是插件问题
- MPE 的导出 PDF 功能依赖 Pandoc,Windows 用户要手动装 Pandoc 并加入 PATH
真正影响体验的只有两件事:预览是否稳定、写作是否顺手。其余功能都是可选项,配错一个参数,整个公式链就断了。










