vscode原生不自动打开markdown预览窗,所谓“自动弹出”均由扩展触发;需重点禁用auto open markdown preview(关其启用选项)及markdown preview enhanced的两个自动预览设置,方可彻底关闭。

VSCode 默认根本不会“自动显示” Markdown 预览窗——所谓“自动弹出”,基本都是扩展干的,不是原生行为。想彻底关掉它,关键不是找“关闭自动预览”的开关,而是分清谁在触发、谁在接管。
确认是不是原生预览在作祟
VSCode 原生不监听文件打开事件来自动唤起预览。如果你一打开 .md 文件就跳出预览窗,那一定是某个扩展在后台运行了逻辑:
- 检查已安装扩展:重点关注
Auto Open Markdown Preview(作者 hnw)、Markdown Preview Enhanced、Markdown All in One - 临时禁用全部 Markdown 相关扩展,重启 VSCode,再打开一个
.md文件——如果预览不再自动出现,说明就是它们之一导致的 - 原生设置
markdown.preview.enabled控制的是“能否使用预览功能”,不是“是否自动打开”;设为false会直接禁用所有预览命令(包括手动按Ctrl+Shift+V),通常没必要走到这步
关掉 Auto Open Markdown Preview 的自动行为
这是最轻量、也最常被误启的自动预览来源。它默认启用,且不提供 UI 开关,必须进设置关:
- 打开设置(
Ctrl+,),搜索auto open markdown preview - 找到选项
Auto Open Markdown Preview: Enabled,取消勾选 - 无需重启,立即生效;再次打开
.md文件时,预览窗将完全静默 - 该扩展不影响其他功能,关掉它后,你仍可用
Ctrl+Shift+V手动唤起预览
停用 Markdown Preview Enhanced 的自动预览干扰
如果你装了 Markdown Preview Enhanced(MPE),它有两个独立的自动触发机制,都得关:
- 搜索设置项
markdown-preview-enhanced.automaticallyShowPreviewOfMarkdownBeingEdited→ 设为false - 再搜
markdown-preview-enhanced.autoShowPreviewToSide→ 同样设为false - 注意:MPE 会覆盖原生预览命令,所以即使你关了它的自动行为,也要确保没同时启用其他扩展的同类功能
- 若你在 Jupyter Notebook 里写 Markdown 时也弹预览,这个设置同样适用——它对所有被识别为 Markdown 的编辑器区域生效
防止预览窗意外复现的隐藏条件
有些场景下,你以为关完了,结果换个窗口或重开文件又弹出来,问题往往藏在这几处:
-
workbench.editor.enablePreview是全局标签页预览开关,设为false可避免任何文件(不只是 Markdown)以“预览模式”打开(即点击文件名时标签页带斜体);但它不直接影响预览窗本身,属于辅助收紧项 - 检查是否绑定了“打开文件时运行命令”的自动化配置(比如通过
settings.json的files.associations+ 自定义任务),极少数工作区配置会偷偷调用markdown.showPreviewToSide - 远程开发(如 Codespaces/SSH)中,某些扩展行为可能与本地不同,建议先在本地窗口验证关闭逻辑是否生效
真正容易被忽略的是:多个扩展可能同时监听 onLanguage:markdown 事件,只要有一个开着“自动预览”,你就拦不住。别只关一个,要挨个查扩展的设置页,尤其注意那些名字不带“preview”但实际干这事的轻量工具。











