必须重启Sublime Text且文件绑定为Markdown语法,否则Ctrl+Shift+P搜不到Markdown Preview命令;未保存的.md文件、右下角显示Plain Text、误装MarkdownEditing等均会导致命令不可见。

Ctrl+Shift+P搜不到markdown_preview命令?重启是硬性前提
安装MarkdownPreview插件后,命令不会热加载进命令面板——哪怕你刚点完Install、窗口还开着,Ctrl+Shift+P里也搜不到markdown_preview。这不是插件没装上,而是Sublime Text的插件注册机制要求完全退出进程再重开。Windows/Linux请右键任务栏图标→“退出”,macOS请用Cmd+Q彻底退出,不能只关窗口。
验证是否生效:按Ctrl+`打开控制台,输入sublime.list_commands(),在返回结果里搜索markdown_preview。没出现?别折腾配置,直接重启。
快捷键绑定必须显式写进Key Bindings – User
Sublime Text默认不给markdown_preview分配任何快捷键,Ctrl+Shift+M或Alt+M都是用户自己加的。打开Preferences → Key Bindings – User(右侧面板),贴入合法JSON对象:
{"keys": ["ctrl+shift+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "github"}}
注意三点:
-
target必须设为"browser",设成"sublime"会导出HTML到新标签页,容易误判为“没反应” -
parser推荐"github"(支持GFM表格、任务列表),不是"markdown"或"mistune"(后者已弃用) - Mac用户若用
Cmd+Shift+M冲突(比如被系统截获),改用super+m更稳妥
文件未保存或语法不对,预览必然失败
按下快捷键却没打开浏览器?先检查两个硬性条件:
- 当前文件必须已保存,且后缀是
.md或.markdown(untitled标签页不触发) - 右下角状态栏必须显示
Markdown GFM(来自MarkdownEditing),不是Markdown(自带极简语法)或Plain Text
如果显示不对,点右下角→Open all with current extension as…→选MarkdownEditing/Markdown GFM。永久生效可进Preferences → Settings – Syntax Specific,加一行:{"extensions": ["md","markdown"]}。
别让MarkdownEditing和OmniMarkupPreviewer共存
这两个插件都注册了preview类命令,同时启用会导致markdown_preview命令被覆盖或执行空白页。如果你装了OmniMarkupPreviewer,又想用MarkdownPreview的快捷键,必须禁用前者:菜单栏Preferences → Package Settings → OmniMarkupPreviewer → Disable Package。
真正容易被忽略的是:插件冲突不报错,只是静默失效——你反复检查快捷键、parser、路径,最后发现是另一个插件在后台劫持了命令入口。











