markdownpreview是sublime text最稳定可控的markdown预览方案，支持python markdown和github api双解析器、语法高亮、自定义模板及多格式导出，但需手动触发预览而非真正实时刷新。
MarkdownPreview 是目前 Sublime Text 上最稳定、最可控的 Markdown 预览方案，但它不支持真正意义上的“实时”刷新（即保存即更新）。所谓“实时”，其实是靠快捷键手动触发 + 浏览器配合自动重载实现的近似效果。别被“Live Preview”类插件名误导——那些带自动监听的，反而容易在 ST4 下崩溃或失灵。
为什么不用 MarkdownLivePreview 或 OmniMarkupPreviewer？
前者已多年未维护，ST4 兼容性差，常报 AttributeError: 'NoneType' object has no attribute 'replace'；后者依赖 Python 的 markdown 库旧版，在启用 fenced code 或表格时渲染异常，且图片路径解析经常出错。而 MarkdownPreview 持续更新到 2026 年初，明确适配 ST3/ST4，错误日志清晰，出问题能快速定位。
怎么装 & 快速验证是否生效？
按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P），输入 Package Control: Install Package，回车后搜 MarkdownPreview（注意结尾是 Preview，不是 Previewer 或 LivePreview）。装完不要重启，直接打开一个 .md 文件，再按 Ctrl+Shift+P 输入 Markdown Preview: Preview in Browser 回车——如果浏览器弹出并显示 HTML 渲染结果，说明成功了。
- 若页面空白或报 404：检查右下角状态栏是否显示
Markdown，不是Plain Text；点它 →Set Syntax → Markdown - 若提示
No parser named 'markdown'：说明 Python-Markdown 未安装，终端运行pip install markdown（确保用的是 Sublime 调用的 Python 环境） - Windows 用户双击 .md 打不开预览？多半是系统默认关联了 Typora 或 Obsidian，导致 Sublime 没获得文件焦点，改用从 Sublime 内部打开文件再试
怎么配快捷键让“伪实时”更顺手？
打开 Preferences → Key Bindings – User，粘贴这一行：
[
{"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "markdown"}}
]
之后编辑时按 Ctrl+Alt+M 就能立刻刷新浏览器页面。别开 "enable_autoreload": true ——这个配置项在新版里已废弃，设为 true 反而会让 Sublime 在保存瞬间卡住甚至崩溃。
- 想渲染得更像 GitHub？把
"parser": "markdown"改成"parser": "github"，但要求联网，离线时会 fallback 失败 - 数学公式要生效，必须加
"markdown_extensions": ["extra", "codehilite", "fenced_code", "tables", "mdx_math"]，且额外装pip install pymdown-extensions - 自定义 CSS 要写成 Sublime 内部路径，比如
"css": ["Packages/User/markdown.css"]，不能写./css/style.css
图片不显示？先盯死这三件事
图片路径错误是预览失败的头号原因，MarkdownPreview 不会帮你 resolve 相对路径。
-
是对的，在某些系统上可能失败（尤其 WSL 或网络挂载盘） - 避免用绝对路径如
C:\docs\img.png，浏览器会因安全策略拒载 - 如果图存在但不显示，右键 → “检查元素”，看
<img src="...">的实际路径是否 404；如果是，说明插件没把图片目录当静态资源服务，需手动复制到输出 HTML 同级目录，或改用OmniMarkupPreviewer的内嵌面板模式（仅限本地小项目）
真正麻烦的地方不在装插件，而在路径、语法绑定和 Python 环境三者的咬合。很多人卡在“点了快捷键没反应”，其实只是右下角写着 Plain Text 而已。
