VSCode默认Markdown预览不支持公式渲染、大纲导航、Mermaid图表、表格对齐及主题匹配；推荐组合Markdown All in One与Markdown Preview Enhanced，需关闭原生预览、启用liveUpdate和mathjaxEnabled并正确配置路径。
VSCode 本身不依赖插件就能写 Markdown，但默认预览功能有限——想实时、美观、带目录/数学公式/图表的预览，必须配置扩展和设置。
Markdown 预览默认行为有哪些限制
VSCode 内置的 Ctrl+Shift+V（Windows/Linux）或 Cmd+Shift+V（macOS）唤出的是基础预览：不支持 LaTeX 公式渲染、无大纲导航、不识别 Mermaid 流程图、表格对齐错乱、代码块主题不匹配当前编辑器主题。
这些不是 bug，是设计取舍——VSCode 把「轻量」放在首位，复杂渲染交给扩展。
- 公式如
$E = mc^2$会原样显示，不会转成数学符号 - 点击标题无法跳转，
[TOC]或[toc]语法被忽略 -
```mermaid块直接显示为纯文本，不绘图 - 预览窗口不随编辑器缩放同步，字号固定
推荐组合：Markdown All in One + Markdown Preview Enhanced
二者分工明确：Markdown All in One 负责写作辅助（快捷键、自动补全、目录生成），Markdown Preview Enhanced（简称 MPE）负责渲染。装两个比只装一个更稳。
windows-shell
下载
Windows 命令行编码与兼容规范。涵盖 GBK/UTF-8 编码、PowerShell/pwsh 互操作、Python/Node.js、Git 配置及代码生成规则。适用于 Windows 10/11 + MSYS2/Git Bash 环境下的所有命令行操作。
MPE 的预览启动方式不是 Ctrl+Shift+V，而是 Ctrl+K V（先按住 Ctrl+K，松开后再按 V），它会新开一个独立预览标签页，支持右键导出 PDF/HTML、实时同步滚动、自定义 CSS。
- 公式需用双美元符：用
$$E = mc^2$$，不是单行$...$（MPE 默认关闭内联公式，可改配置开启） - Mermaid 支持开箱即用，但需确保系统已安装
mermaid-cli（仅导出时需要，预览不需要） - 目录生成：在文档任意位置插入
[TOC]，保存后自动填充；支持多级、折叠/展开 - 预览页右键 → “Open Preview to the Side” 可并排查看，避免来回切换
关键配置项别漏掉
装完插件不配置，等于白装。重点改这三项：
- 关闭 VSCode 自带预览：在设置里搜
markdown.preview.enabled，设为false - 让 MPE 监听文件变化：设置中找
markdown-preview-enhanced.liveUpdate，勾选 - 启用数学公式：设置中搜
markdown-preview-enhanced.mathjaxEnabled，设为true；若想支持内联公式，再开markdown-preview-enhanced.enableExtendedMathjax - 路径别写错：MPE 的自定义 CSS 文件要放在工作区根目录下，路径填
./md-styles.css（注意开头的./）
真正卡住人的往往不是不会装插件，而是预览不刷新、公式不渲染、TOC 不更新——这些问题 90% 出在没关掉原生预览，或配置项拼写错误（比如把 mathjaxEnabled 写成 mathJaxEnabled）。配置改完记得重启预览窗口，不是重启 VSCode。
