Sublime Text本身不支持Markdown预览，需安装MarkdownPreview插件并手动触发；常见问题包括未重启、语法未识别、Python环境异常、Build System劫持及装错插件。
Sublime Text 本身不打开、不渲染、也不“实时预览” Markdown —— 它只负责编辑文本，所有预览能力都来自插件，且所谓“实时”是伪实时，必须手动触发或靠外部工具联动。
Markdown Preview 插件装完没反应？先查这五件事
常见错误现象：Ctrl+Shift+P 搜不到 Markdown Preview: Preview in Browser，右键菜单无选项，快捷键 Ctrl+Alt+M 按下没反应。
- 没重启 Sublime：插件安装后必须重启，否则命令未加载到命令面板
- 文件没识别为 Markdown：右下角状态栏显示的是
Plain Text而非Markdown；点击它 →Open all with current extension as → Markdown - Python 环境异常：Sublime 自带 Python（v3.3+）被其他插件污染，或系统 Python 版本过低；在控制台（
Ctrl+`）执行import sys; print(sys.version)，确保输出 ≥ 3.6 - Build System 被劫持：误设了
Tools → Build System → Python或自定义.sublime-build文件，会抑制插件命令；切回Automatic - 装错插件：搜
MarkdownEditing装了——它只管高亮，不提供预览；必须装MarkdownPreview（注意拼写，无空格、无 s）
怎么让 Ctrl+Alt+M 快捷键真正生效
默认快捷键只在 text.html.markdown 作用域下触发，不是所有 .md 文件都自动匹配该作用域。
- 确认当前文件语法是
Markdown（右下角可见），否则快捷键完全不注册 - 检查是否被其他插件覆盖：打开
Preferences → Key Bindings – User，搜索markdown_preview，删掉冲突项 - 手动绑定更可靠：在
Key Bindings – User中加这一行：[{"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "markdown"}}] - 别用
Ctrl+B：那是 Build System 的快捷键，和 Markdown 预览无关，强行绑定只会报错
为什么开了 enable_autoreload: true 反而更卡
新版 MarkdownPreview（2026 年起）中，enable_autoreload 已不推荐启用。它不监听文件保存事件，而是轮询临时 HTML 文件变化，容易引发资源竞争、浏览器失焦、甚至空白页。
- 真实行为：它只对已通过插件打开的预览页生效，首次仍需手动触发
Preview in Browser - 副作用明显：开启后，频繁保存时浏览器标签页可能卡死、CSS 加载失败、mathjax/mermaid 渲染中断
- 更稳方案：保持
"enable_autoreload": false（默认值），用快捷键Ctrl+Alt+M手动刷新，响应快、无干扰 - 真要“自动”：得配
LiveReload插件 + 浏览器扩展，并手动指向 Markdown Preview 的缓存 HTML 路径，但稳定性差，仅适合离线调试
预览样式丑、代码没高亮、中文锚点失效？别乱改 CSS
问题大概率出在解析阶段，不是样式没加载，而是 HTML 根本没生成对应结构。
- 代码块不亮色？说明
codehilite扩展没启用，或依赖的Pygments缺失；在用户配置中加："parser": "markdown",<br>"markdown_extensions": ["fenced_code", "codehilite", "tables"]
- 中文标题链接跳转失败？不是编码问题，是 URL 解码逻辑未激活；必须同时启用：
"html_preview": true,<br>"enable_highlight": true
- 表格、任务列表不渲染？
parser: "github"离线不可用，fallback 后效果打折；换"parser": "mistune"更轻量、GFM 支持更全 - 别双击临时
.html文件：路径在缓存目录（如~/Library/Caches/Sublime Text/Cache/Markdown Preview/），直接打开会丢 CSS/JS，必须用插件内置方式打开
最易被忽略的一点：所有配置修改后，必须关闭并重开预览页才能生效——浏览器缓存会复用旧 HTML，即使你改了 CSS 或 parser，不关页就看不到变化。
