sublime text 本身不支持 markdown 预览或实时刷新,必须依赖 markdownpreview 插件;按 ctrl+alt+m 无反应主因是文件未保存、语法未设为 markdown、插件未重启生效,或 enable_autoreload 已废弃导致冲突。

Sublime Text 本身不运行 Markdown,也不“实时预览”——所谓预览是 MarkdownPreview 插件调用 Python 解析器生成 HTML,再由浏览器加载;保存即刷新只是靠 enable_autoreload 向已打开的标签页发刷新指令,不是 Sublime 自身能力。
为什么按 Ctrl+Alt+M 没反应?
快捷键失效几乎全是触发条件没满足,不是插件坏了:
- 当前文件必须已保存,且后缀是
.md或.markdown;未保存的untitled标签页不会响应 - 右下角状态栏必须显示
Markdown(不是Plain Text);点它 →Set Syntax → Markdown或Markdown GFM - 快捷键只在
text.html.markdown作用域生效;语法识别错,按键就完全被忽略 - 插件安装后没重启 Sublime,命令根本没注册进系统;
Ctrl+Shift+P里搜markdown_preview看是否在列表中
enable_autoreload 设为 true 反而卡死?
是的,2026 年起该配置已被废弃,设为 true 在 ST4 + Windows 下极易导致保存瞬间卡住甚至崩溃:
- 真正起作用的是浏览器端自动重载机制,不是 Sublime 的监听逻辑
- 首次必须手动执行一次
Markdown Preview: Preview in Browser,之后保持该标签页打开、URL 是file://或http://127.0.0.1:开头,保存才会触发刷新 - Chrome/Edge 用户务必关闭
chrome://settings/privacy里的「使用预测服务来加载网页」,否则本地文件刷新常被拦截
表格不渲染、公式不显示、Mermaid 图表空白?
默认解析器 "parser": "markdown" 只支持基础语法,高级特性需显式启用或换解析器:
- 表格/任务列表/删除线:改用
"parser": "mistune"(离线可用),或加扩展"markdown_extensions": ["tables", "fenced_code"] - 数学公式:加
"mathjax_enabled": true,公式用$$...$$或\( ... \)包裹;注意 MathJax CDN 需可访问 - Mermaid 图表:仅开
mathjax_enabled不行,必须配"markdown_extensions": ["mermaid2"],且提前在 Sublime 调用的 Python 环境里pip install mermaid2
预览页面空白或中文乱码?
这类问题基本和路径、编码、服务代理有关,跟 Markdown 写法无关:
- 文件编码必须是
UTF-8:右下角点编码名 → 选UTF-8;乱码会导致解析中断,页面直接空白 - 避免中文路径和空格路径,例如
C:\我的文档\test.md容易出错;推荐用C:\md\test.md - 别双击生成的临时 HTML 文件——必须通过插件命令
Preview in Browser打开,它走的是 Sublime 的本地服务代理,CSS/JS 才能正常加载
最常被忽略的一点:所有“实时”效果都依赖首次手动触发那一下;没点过 Preview in Browser,后续任何配置都是空转。











