markdownpreview是sublime text中唯一靠谱的markdown预览插件，因其持续更新至2026年初、支持st3/st4、错误日志清晰、纯离线运行，且自带mathjax_enabled和mermaid开关、支持自定义css/html模板及多解析器，导出html/pdf稳定；而markdownlivepreview和omnimarkuppreviewer因多年不维护或依赖旧库已被淘汰。
只装 MarkdownPreview，别碰 MarkdownLivePreview 或 OmniMarkupPreviewer。前者已多年不维护，在 ST4 下常报 AttributeError: 'NoneType' object has no attribute 'replace'；后者依赖旧版 markdown 库，遇到代码块或表格就渲染错，图片路径也经常 404。
为什么 MarkdownPreview 是唯一靠谱选择
它持续更新到 2026 年初，明确标注支持 ST3/ST4，错误日志清晰，出问题能直接定位到哪一行配置或哪个 Python 模块缺失。其他插件要么只管语法高亮（如 MarkdownEditing），要么和它冲突导致右键菜单消失、快捷键失效。
- 不依赖外部服务，纯离线可用
- 自带
mathjax_enabled和mermaid开关，公式和流程图可配 - 支持自定义 CSS、HTML 模板、多解析器（
markdown/github） - 导出 HTML/PDF 功能稳定，不像某些插件导出后样式全丢
MarkdownPreview 安装后没反应？先查这四点
命令面板能搜到 Markdown Preview: Preview in Browser 却点不动，大概率不是插件坏了，而是环境没对齐：
- 文件没保存：必须是已保存的
.md文件，新建未存的 tab 插件压根不处理 - 编码不是 UTF-8：含中文路径或内容时，若为 GBK，预览页会空白，用
File → Reopen with Encoding → UTF-8重载 - 右下角状态栏不是
Markdown：点它 →Set Syntax → Markdown，否则插件不触发 -
No parser named 'markdown'：说明系统没装markdown库，终端运行pip install markdown（注意用 Sublime 调用的 Python 环境）
怎么让“保存即刷新”真正跑起来
"enable_autoreload": true 单独加在设置里没用——它只是让插件监听文件变化，实际刷新靠浏览器端配合：
- 首次必须手动执行一次
Markdown Preview: Preview in Browser，之后保存才开始监听 - Chrome / Edge 用户需装
LiveReload扩展，并在扩展设置中启用Allow access to file URLs - 别开
"enable_autoreload": true还配"include_mathjax": "cdn"：没网时公式不渲染，且 CDN 加载失败会导致整个页面卡住 - Windows 双击 .md 打不开预览？多半是系统默认关联了 Typora 或 Obsidian，改用从 Sublime 内部打开文件再试
真正麻烦的不是装插件，而是路径里带中文、文件没保存、浏览器没授权访问本地文件——这些细节一错，整个预览链就断了。
