markdownpreview是sublime text实现markdown预览的唯一可靠插件；ctrl+shift+p搜不到命令主因是未重启编辑器，安装后必须完全退出再重开才能注册命令，且文件需保存为.md/.markdown、右下角显示markdown语法，避免与markdownediting等插件冲突。
MarkdownPreview 插件是唯一靠谱的路径，不装它，Sublime Text 就永远看不到 Markdown 渲染效果。
为什么 Ctrl+Shift+P 里搜不到 Markdown Preview？
不是插件没装好，而是你没重启 Sublime Text。插件安装后命令不会热加载，必须完全退出再重开——哪怕只是关掉窗口、没点“退出程序”，命令也不会注册。
确认是否生效，可以按 Ctrl+` 打开控制台，输入：
sublime.list_commands()
然后搜索 markdown_preview 是否在返回列表里。如果没出现，重启是最直接的解法。
- 文件必须已保存，且后缀是
.md或.markdown（untitled标签页不触发预览） - 右下角状态栏必须显示
Markdown，不是Plain Text；点它 →Open all with current extension as…→Markdown - 别和
MarkdownEditing或OmniMarkupPreviewer同时启用，它们会冲突，导致命令消失或预览空白
怎么设置一键浏览器预览快捷键？
默认没绑定快捷键，得手动加。打开 Preferences → Key Bindings（右侧用户配置），贴入：
{ "keys": ["alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "markdown"} }
alt+m 在 Windows/Linux 有效；Mac 用户用 super+m 更稳妥（super 是 Cmd 键）。
-
target设为"browser"才能打开浏览器，设成"sublime"是导出 HTML 到新标签页，容易误以为失败 -
parser选"markdown"表示用本地 Python Markdown 解析器（离线、快、稳定）；选"github"需联网，支持表格但慢且偶尔超时 - 如果快捷键不起作用，检查是否被系统或其他插件占用（比如某些输入法会劫持
alt+m）
为什么保存后浏览器不自动刷新？
这不是 bug，是默认关闭的。要实现“保存即刷新”，得三步联动：
- 在
Preferences → Package Settings → Markdown Preview → Settings中开启："enable_autoreload": true - 浏览器需装 LiveReload 扩展（Chrome/Firefox 均有官方版），并确保已启用
- 首次预览必须通过
markdown_preview命令打开页面，不能手动拖 HTML 文件进浏览器——只有插件注入的 script 才能触发 reload
中文路径或含空格的路径会导致 autoreload 失效，建议把项目放在 C:/md/ 或 /home/user/md/ 这类纯英文路径下。
预览空白/报错常见原因
最常遇到的是页面白屏或显示原始 Markdown 文本，而不是渲染后的内容。这通常不是语法问题，而是环境链断了：
- 文件未保存 → 插件读不到内容 → 输出空 HTML
- 路径含中文或空格 →
file://协议解析失败 → 浏览器拒绝加载资源（尤其是 CSS 和 JS） - 数学公式没启用 → 若文档含
$...$，需在设置中加："enable_math": true，否则整个页面可能卡住或报 JS 错误 - 用了 GFM 表格但 parser 没配扩展 → 默认
markdown解析器不支持表格，得加："extensions": ["extra", "tables"]
真正麻烦的从来不是写 Markdown，而是让预览链每个环节都对上——文件名、语法模式、解析器、路径、浏览器扩展，缺一不可。
