VSCode Markdown预览默认开启但易受禁用、快捷键冲突、未保存文件、插件干扰等影响;需检查markdown.preview.enabled、文件后缀、自动保存及插件兼容性,导出依赖系统环境与正确路径配置。

Markdown预览默认就开启,但可能被禁用或冲突
VSCode 自带 Markdown 预览功能,Ctrl+Shift+V(Windows/Linux)或 Cmd+Shift+V(macOS)直接呼出。如果按了没反应,不是没装插件,而是预览被关了或快捷键被覆盖。
- 检查设置里是否误关:
markdown.preview.enabled必须为true - 确认当前文件后缀是
.md或.markdown,VSCode 不识别.txt或无后缀文件 - 某些键盘映射插件(如 Vim、Emacs 模式)会劫持
Ctrl+Shift+V,可临时禁用插件验证 - 右键编辑器空白处选「Open Preview to the Side」也能强制唤起,比记快捷键更稳
实时刷新不工作?多半是文件未保存或设置了延迟
VSCode 的 Markdown 预览默认是「保存后刷新」,不是 Typora 那种真·实时。改完不按 Ctrl+S,预览不会变——这点最容易让人以为“坏了”。
-
markdown.preview.autoRefresh控制是否自动刷新,默认true,但只对已保存文件生效 - 想边写边看,必须开「自动保存」:
files.autoSave设为onFocusChange或afterDelay - 若用了
markdown.extension.italic.indicator等第三方插件,可能干扰刷新逻辑,建议先禁用测试 - 预览窗口右上角有刷新按钮(↻),点一下能手动触发重载,适合调试时快速验证
预览样式难看?别动 CSS,优先调配置项
很多人一上来就去改 markdown.styles 或找 CSS 文件,其实 VSCode 提供了更轻量的控制方式,改错路径反而让预览白屏。
-
markdown.preview.fontSize和markdown.preview.fontFamily直接调字体大小和字体,不用碰 CSS - 深色主题下文字发灰?调整
workbench.colorCustomizations里的markdownPreview.foreground - 要加自定义样式,
markdown.preview.styles填的是绝对路径或相对工作区根目录的.css文件,比如["./styles/md-preview.css"],不是 URL - 路径写错会导致预览空白且无报错,打开开发者工具(
Help → Toggle Developer Tools)看 Console 有没有 404
导出 PDF 或 HTML 失败?权限和依赖才是关键
VSCode 内置预览不支持导出,得靠插件(如 Markdown PDF)。但装了也常失败,问题不在操作,而在环境。
-
Markdown PDF依赖系统级chromium或electron,Windows/macOS 一般没问题,Linux 可能缺libxss1、libglib2.0-0等包 - 导出时报
Failed to launch browser,大概率是权限或沙箱冲突,试试在设置里加"markdown-pdf.executable": "/usr/bin/chromium"指定路径 - 中文乱码?PDF 插件默认不嵌入中文字体,需在插件设置里填
markdown-pdf.fontFamily,比如"Noto Sans CJK SC, sans-serif" - 导出 HTML 用内置命令
Markdown: Export to HTML更稳,不依赖外部二进制,但样式就是预览页的快照,不支持额外模板
预览功能本身很轻,但一旦混入插件、自定义样式、导出流程,每个环节都可能卡在路径、权限或隐式依赖上。最省事的方式:先关所有 Markdown 相关插件,用原生预览跑通,再一个个加回来定位问题。










