直接按 Ctrl+Shift+V(Windows/Linux)或 Cmd+Shift+V(macOS)即可在侧边栏打开 Markdown 实时预览,需确保文件为 .md/.markdown 后缀、语言模式设为 Markdown,且内置 Markdown 扩展已启用。

直接按 Ctrl+Shift+V(Windows/Linux)或 Cmd+Shift+V(macOS)就能在侧边栏打开 Markdown 实时预览,无需额外配置。
Markdown 文件默认支持,但要注意文件后缀和编辑器状态
VSCode 自带的 Markdown 预览功能只对 .md 和 .markdown 后缀生效;如果文件是 README 无后缀,或被误识别为纯文本,Ctrl+Shift+V 会无效。此时需右键文件标签 → “重新使用语言模式” → 选 Markdown。
- 预览启动后,编辑器会自动分屏:左侧写源码,右侧渲染效果
- 滚动同步默认开启,但若失效,检查设置中是否启用了
markdown.preview.scrollEditorWithPreview - 图片路径相对当前文件位置解析,不是工作区根目录——这点常导致本地图片不显示
Live Server 插件无法用 Ctrl+Shift+V 开侧边预览
Live Server(ms-vscode.live-server)和 Live Preview 是两套机制:Ctrl+Shift+V 是 VSCode 内置 Markdown 预览快捷键,只对 Markdown 生效;而 Live Server 默认启动的是外部浏览器窗口或内嵌 iframe 页面,不走侧边栏预览通道。
- 想用 Live Server 做 HTML 侧边预览,得装
Browser Preview插件,再点侧边栏Browser Preview按钮 -
Live Preview插件虽名字像,但它默认开的是独立预览标签页,不是侧边栏——除非你在设置里把livePreview.openPreviewTarget改成Embedded Preview - 多个预览插件共存时,快捷键可能被覆盖,建议禁用不用的预览类扩展,避免冲突
侧边预览打不开?先查这三件事
常见现象是按下快捷键没反应、预览空白、或弹出错误提示 Cannot preview file: no preview provider。
- 确认当前打开的是
.md文件,且未处于搜索结果、调试控制台等非编辑器上下文 - 检查是否禁用了内置 Markdown 扩展:在扩展面板搜
@builtin markdown,确保Markdown Language Features和Markdown Preview已启用 - 某些主题或自定义 CSS 会隐藏预览侧边栏区域,可临时切换为默认
Dark+主题验证
侧边预览看着简单,但真正稳定运行依赖三个隐性条件:正确的文件类型识别、未被插件劫持的快捷键、以及预览容器本身没被 UI 层级遮挡——这三个点不排查清楚,装再多插件也没用。











