sublime text 本身不支持 markdown 实时预览，需依赖 markdownpreview 插件配合浏览器自动重载实现“准实时”效果；必须确保文件语法识别为 markdown、python 环境正常、首次手动触发预览，且禁用已废弃的 enable_autoreload 配置。
Sublime Text 本身不支持 Markdown 实时预览，所谓“实时”是靠 MarkdownPreview 插件 + 浏览器自动重载模拟出来的效果，不是保存就刷新的原生能力——这点必须先确认清楚，否则后续所有配置都会跑偏。
装完 MarkdownPreview 没反应？先查语法识别和 Python 环境
插件装完没命令、快捷键无效、右键菜单空白，90% 是因为 Sublime 没把当前文件当成 Markdown 处理：
- 看右下角状态栏是否显示
Markdown；如果显示Plain Text，点它 →Set Syntax → Markdown - 确保文件已保存且后缀为
.md或.markdown；未保存的临时文件不会触发预览 - Sublime Text 4 自带 Python 3.8+，一般不用额外装；但若控制台（
Ctrl+`）里运行import sys; print(sys.version)报错或版本低于 3.3，说明环境异常，需重装官方版 - 安装插件后必须重启 Sublime，否则命令面板搜不到
Markdown Preview: Preview in Browser
enable_autoreload 到底要不要开？新版里设为 true 反而会卡死
很多老教程说加 "enable_autoreload": true 就能“实时”，这是过时信息。2026 年起该配置项已被废弃：
Markdown Converter 1.0.0
下载
使用 markitdown 将文档和文件转换为 Markdown。适用于转换 PDF、Word (.docx)、PowerPoint (.pptx)、Excel (.xlsx, .xls)、HTML、CSV、JSON、XML 等格式。
- 设为
true会导致 Sublime 在保存瞬间卡住，甚至崩溃（尤其 ST4 + Windows） - 真正起作用的是浏览器端的自动重载机制：首次手动执行一次
Markdown Preview: Preview in Browser，之后只要保持该标签页打开且 URL 是file://或http://127.0.0.1:开头，保存即刷新 - Chrome/Edge 用户需关闭设置里的「使用预测服务来加载网页」（
chrome://settings/privacy），否则本地文件刷新常被拦截
快捷键绑定失败？检查作用域和冲突
Ctrl+Alt+M（Windows/Linux）或 Cmd+Alt+M（macOS）默认只在 text.html.markdown 作用域下生效：
- 如果快捷键没反应，先用鼠标菜单
Tools → Markdown Preview → Preview in Browser测试是否插件本身正常 - 进
Preferences → Key Bindings，右侧用户键位里搜markdown_preview，确认没被其他插件覆盖 - 推荐手动加一条干净绑定（避免平台差异）：
[ {"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "markdown"}} ] - 别同时装
OmniMarkupPreviewer或MarkdownEditing的预览模块——它们会和MarkdownPreview冲突，导致右键菜单消失或保存卡顿
中文路径、公式、Mermaid 图表怎么搞？别指望全兼容
MarkdownPreview 对中文路径容忍度极低，数学公式和图表支持也依赖额外条件：
- Windows 用户遇到预览空白或报错，先把文件移到纯英文无空格路径（如
C:\md\test.md）再试 - 公式支持需显式开启：
"enable_math": true，且浏览器要能加载 MathJax；离线环境建议用 KaTeX 替代，但需自定义模板 - Mermaid 渲染需要
"enable_mermaid": true+ 浏览器支持 ES6 模块，部分旧版 Edge 直接不渲染 - GitHub 风格解析（
"parser": "github"）必须联网，离线时 fallback 到本地解析器，表格、脚注等表现可能不一致
最常被忽略的一点：所谓“实时”完全依赖浏览器标签页是否保持活跃且未被其他程序抢占焦点。如果你习惯双击 .md 文件用 Typora 打开，再切回 Sublime 编辑，Sublime 往往收不到文件系统变更通知——务必从 Sublime 内部用 File → Open 打开文件，才能稳定触发保存监听。
