Sublime Text预览Markdown必须同时安装MarkdownEditing和MarkdownPreview插件，缺一不可；仅装前者可高亮但无法预览，仅装后者则语法识别失败、命令不可见；安装后须重启、设语法为Markdown GFM、配置parser为github并启用mathjax，否则样式、公式均不渲染。
装完 MarkdownPreview 插件后，预览默认就是生成静态 HTML 文件——它不依赖服务器，也不走网络，直接写入临时目录并用浏览器打开。所谓“静态网页”，正是它的默认行为，不是额外功能，也无需开启特殊开关。
必须同时装 MarkdownEditing 和 MarkdownPreview
只装 MarkdownPreview，.md 文件在 Sublime 里仍是 Plain Text，右下角不显示 Markdown，Markdown Preview: Preview in Browser 命令根本不会出现；只装 MarkdownEditing，能高亮、能快捷插入标题，但点预览会报 command not found: markdown_preview。
- 安装顺序无所谓，但两个都得通过 Package Control 装（别搜 “Markdown Previewer” 或 “OmniMarkupPreviewer”，那些已停更或不兼容）
- 装完必须重启 Sublime，否则插件不加载，命令面板搜不到相关命令
- 打开 .md 文件后，务必点击右下角语言标识 → 选
MarkdownEditing → Markdown GFM，否则 GitHub 表格、任务列表、数学公式等特性不生效
parser 设成 github 才能渲染样式和公式
默认解析器是 markdown，它只转基础语法，不加载 GitHub CSS、不支持 MathJax。如果你预览出来是白底黑字、表格错位、公式显示为原始 LaTeX，说明 parser 没配对。
- 进
Preferences → Package Settings → Markdown Preview → Settings – User - 加这三行（缺一不可）：
"parser": "github", "enable_mathjax": true, "github_mode": true
- 注意：
gfmparser 不支持 MathJax，必须用github或markdown配enable_mathjax
快捷键、自动刷新、浏览器路径全得手动配
MarkdownPreview 默认不绑快捷键、不监听保存、不指定浏览器——你按 Ctrl+B 没反应，不是插件坏了，是它压根没接管这个键位。
- 快捷键：进
Preferences → Key Bindings – User，加一行：{"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "github"}} - 自动刷新：设
"enable_autoreload": true，但仅对已保存的本地文件有效；未保存的 untitled 标签页或远程路径不触发 - 浏览器路径：Windows 上若报
Permission denied，改"browser": "default"；macOS 若 Safari 空白，临时切"browser": "safari"；Chrome 路径含空格时，用正斜杠写成"browser": "C:/Program Files/Google/Chrome/Application/chrome.exe"
预览空白页？先看控制台报什么错误
空白页几乎从不因为插件本身损坏，而是环境或配置断链。打开 View → Show Console，再执行预览，看输出：
-
ImportError: No module named markdown→ 运行pip install markdown（用系统 Python，不是 Sublime 自带的那个） -
UnicodeEncodeError: 'gbk' codec can't encode character→ 文件路径含中文，要么改路径，要么在设置里加"encoding": "utf-8" - 控制台没报错但页面空白 → 检查浏览器是否拦截了本地文件协议（file://）的样式加载，换 Chrome 并确保没开“阻止弹出窗口”
最常被忽略的一点：所有配置项都必须写在 Settings – User 里，而不是 Settings – Default；改错文件等于没改。另外，enable_autoreload 和 LiveReload 是两套机制，后者需额外装插件并手动启用，前者纯靠插件自身轮询，别混用。
