markdown preview插件装完没反应，需确认四件事：是否正确安装markdownpreview、是否重启sublime、右下角是否显示markdown语法、文件是否已保存为.md后缀；快捷键仅在text.html.markdown作用域生效，python版本需≥3.6，启用autoreload才支持保存后自动刷新。
Markdown Preview 插件装完没反应？先确认这四件事
Sublime Text 本身不带任何 Markdown 渲染能力，所谓“预览”全靠 MarkdownPreview 插件驱动。装完就用不了，不是插件问题，而是环境链断了。
必须检查：
- 是否通过
Package Control: Install Package安装的是MarkdownPreview（注意结尾是Preview，不是Previewer或LivePreview） - 安装后是否重启了 Sublime —— 不重启，
Ctrl+Shift+P里搜不到Markdown Preview命令 - 当前文件右下角状态栏是否显示
Markdown（不是Plain Text）；若不是，点击它 →Set Syntax: Markdown - 文件是否已保存为
.md后缀 —— 未保存的untitled标签页不会触发预览
为什么按 Ctrl+Alt+M 没反应？快捷键只在特定条件下生效
Ctrl+Alt+M（Windows/Linux）或 Cmd+Alt+M（macOS）是默认快捷键，但它只在 text.html.markdown 语法作用域下触发。这不是 bug，是 Sublime 的作用域机制设计。
常见失效原因：
- 右下角语法显示不是
Markdown，而是Plain Text或Markdown GFM（后者是MarkdownEditing提供的，不被MarkdownPreview识别） - 快捷键被其他插件覆盖：打开
Preferences → Key Bindings – User，搜索markdown_preview，确认没有重复或冲突绑定 - 当前文件未保存，或保存路径含中文/空格/特殊符号，导致插件内部路径解析失败
- 手动改过 Build System（比如设成了
Python），请切回Automatic
预览空白 / 打不开浏览器 / 报 404？大概率是 Python 或浏览器路径卡住了
MarkdownPreview 依赖 Python 环境生成 HTML，再调用浏览器打开本地文件。两个环节任一出错，都会静默失败或白屏。
排查重点：
- 在 Sublime 控制台（
Ctrl+`）运行import sys; print(sys.version)，确保输出 ≥3.6；Sublime 4 自带3.8+，但 Sublime 3 用户需确认系统 PATH 中有可用 Python - 若用
pyenv或conda，必须在Markdown Preview → Settings – User中显式指定："python_binary": "/path/to/your/python" - 浏览器路径未配置时，默认调用系统默认浏览器；但如果 Chrome 不在 PATH（如 macOS 上的多用户版、Windows 上的便携版），就得写死路径：
"browser": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"或"browser": "C:\Program Files\Google\Chrome\Application\chrome.exe" - 文件编码不是
UTF-8（右下角点编码名 → 选UTF-8），中文乱码会导致解析中断，页面空白
想“实时刷新”？别信宣传词，得手动配 autoreload + LiveReload
Sublime 没有真正的实时预览机制。MarkdownPreview 默认是静态快照：你按一次 Preview in Browser，它生成一个 HTML 文件并打开；之后修改保存，页面不会自动刷新 —— 这是设计如此，不是你配错了。
伪实时方案只有两个可靠路径：
- 启用
"enable_autoreload": true（在Markdown Preview → Settings – User中添加），然后首次必须手动执行一次Markdown Preview: Preview in Browser，之后保存才会触发自动重载（仅限已打开的预览页） - 配合
LiveReload插件：安装后执行LiveReload: Enable/disable plug-ins → Enable: Simple Reload，再在浏览器中手动启用 LiveReload 插件（如 Chrome 扩展），才能监听本地变化并刷新 - 注意：
"parser": "github"需联网，离线时 fallback 到本地解析器，表格、任务列表等 GFM 特性可能丢失；若追求稳定，推荐"parser": "mistune"，轻量且无需 Pygments
中文锚点（如 [标题](#中文标题)）点击跳转失败？加这两项配置："html_preview": true 和 "enable_highlight": true —— 高亮逻辑会顺带激活 URL 解码，否则浏览器地址栏显示 %E4%B8%AD%E6%96%87 却找不到对应 ID。
