VS Code 通过禁用内置预览、安装 Markdown All in One 并配置自定义 CSS 和 markdown-pdf 扩展,即可实现接近 Typora 的高效 Markdown 编辑体验。

VS Code 本身不内置完整的 Markdown 渲染引擎,但通过轻量配置即可实现接近 Typora 的实时预览体验——关键不在装多少插件,而在选对核心扩展、关掉干扰项、用好快捷键。
安装 Markdown All in One 和禁用默认预览冲突
VS Code 自带基础 Markdown 支持,但 Markdown All in One 提供目录生成、快捷键增强(如 Ctrl+Shift+P → Markdown: Create Table)、自动补全标题等刚需功能。注意:它会与 VS Code 内置的 Markdown Preview 共存,导致右键菜单重复、热重载不稳定。解决方法是禁用内置预览:
- 打开设置(
Ctrl+,),搜索markdown.preview.enabled,设为false - 或在
settings.json中添加:"markdown.preview.enabled": false - 重启窗口后,用
Ctrl+Shift+V触发Markdown All in One的预览,它基于 VS Code Webview,加载快且支持数学公式(需开启markdown.extension.math.enabled)
用 Typora 风格主题 + 行内样式微调
默认预览字体小、行距紧,阅读吃力。不推荐装“Markdown Preview Enhanced”这类重型扩展(易卡顿、更新慢),而是直接改预览 CSS:
- 在用户数据目录下创建
markdown.css(路径示例:~/.vscode/extensions/shd101wyy.markdown-preview-enhanced-*/styles/markdown.css—— 实际请查Markdown All in One文档指定位置) - 写入简短样式,例如:
body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial; line-height: 1.6; } - 在
settings.json中指定:"markdown.styles": ["./markdown.css"]
启用 Auto Save 和 Format on Save 避免手动操作
写作时最打断节奏的是频繁保存和格式整理。VS Code 原生支持这两项,无需插件:
-
"files.autoSave": "afterDelay"(延迟保存,避免光标跳动) -
"editor.formatOnSave": true,再配合Markdown All in One的"markdown.format.enable": true - 效果:敲完列表或代码块回车后,自动对齐缩进;标题后多空格会被清理;表格对齐符号自动补齐
导出 PDF 时字体/目录失效?用 markdown-pdf 替代打印
直接用浏览器打印预览页,中文常变方框、TOC 不渲染。更稳的方式是用 markdown-pdf 扩展(注意不是同名旧版):
- 安装后按
Ctrl+Shift+P→ 输入Markdown PDF: Export (pdf) - 它底层调用 Puppeteer,可读取你自定义的
markdown.css,中文字体正常 - 若目录不显示,请确认文档里有
[TOC]标记(Markdown All in One默认支持),且启用了"markdown.extension.toc.githubCompatibility": true
真正卡住效率的往往不是功能缺失,而是预览刷新延迟、导出样式错乱、或是误启了多个预览实例互相抢占资源。把 markdown.preview.enabled 关掉、CSS 路径写对、PDF 导出走专用扩展——这三步做完,剩下的就是专注写内容了。










