Sublime Text需装MarkdownPreview插件实现Markdown预览，推荐手动刷新而非自动同步；配置浏览器和快捷键（如Ctrl+Alt+M）可提升稳定性，避免因语法错误、路径问题或扩展名不匹配导致预览失败。
Sublime Text 本身不支持原生 Markdown 实时预览，必须借助插件；最稳定、轻量、兼容性好的方案是 MarkdownPreview + 手动刷新（或绑定快捷键），而不是追求“自动同步到浏览器”——后者在 Sublime 中极易出错、卡顿或失焦。
装对插件：别选错名字，MarkdownPreview 不是 MarkdownEditing
MarkdownEditing 只提供语法高亮和编辑增强，不带预览功能；真正负责生成 HTML 并打开浏览器的是 MarkdownPreview。安装方式只有两种可靠路径：
- 通过 Package Control：按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package，再搜MarkdownPreview（注意拼写，结尾是Preview，不是Previewer或LivePreview） - 手动安装：克隆仓库到
Packages/MarkdownPreview目录，但需确保依赖python-markdown已就绪（一般自动处理） - 装完后重启 Sublime 或执行一次
MarkdownPreview: Preview in Browser命令验证
配置浏览器：默认用系统默认浏览器，但可指定 Chrome / Edge / Firefox
默认行为是调用系统默认浏览器，但如果你用的是 Chrome 多用户配置、Edge Dev 版、或想避开 Safari 的渲染差异，就得改配置。打开 Preferences → Package Settings → MarkdownPreview → Settings – User，填入：
{
"browser": "chrome",
"enable_autoreload": false,
"markdown_extensions": ["extra", "codehilite", "fenced_code", "tables"]
}
其中 "browser" 支持的值有："chrome"、"firefox"、"edge"、"safari"；若 Chrome 不在 PATH，可写绝对路径，例如："C:\Program Files\Google\Chrome\Application\chrome.exe"（Windows）或 "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"（macOS）。
实时？别信“自动刷新”，用快捷键更稳
MarkdownPreview 的 "enable_autoreload": true 在多数场景下不可靠：它依赖文件系统事件监听，Sublime 自身未暴露完整 API，容易漏触发、重复刷新、甚至导致浏览器标签页崩溃。实际推荐做法是关闭自动刷新，改用快捷键手动触发：
- 绑定快捷键：打开
Preferences → Key Bindings – User，加一行：{"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser":"markdown"}} - 每次修改后按
Ctrl+Alt+M（Windows/Linux）或Cmd+Alt+M（macOS），立刻更新当前文件的 HTML 预览 - 如果同时开多个 Markdown 文件，该快捷键只作用于当前激活 tab，不会干扰其他页面
导出 HTML 或调试失败时看日志
预览打不开？常见原因不是插件没装好，而是 Markdown 语法错误（比如多层嵌套列表缺空行）、路径含中文、或扩展名没识别为 .md。打开 Sublime 控制台（Ctrl+`），执行预览命令后观察输出：
- 若出现
KeyError: 'html'，说明markdown_extensions配置里写了不存在的扩展名 - 若提示
File not found，检查文件是否已保存（未保存的临时文件无法预览） - 若浏览器打开空白页，右键 → “查看页面源代码”，确认是否生成了 HTML；没有则说明解析中途退出，大概率是 YAML front matter 格式不对或缩进错误
复杂文档建议先用 markdownlint 或 VS Code 验证语法，再切回 Sublime 预览——毕竟它的强项是编辑，不是实时渲染引擎。
