Sublime Text 安装 Markdown Preview 后无法预览，需手动触发命令或配置快捷键；常见问题包括插件未启用、语法未识别为Markdown、解析器与配置不匹配、ST4兼容性差及样式/公式渲染异常。
Sublime Text 装完 Markdown Preview 插件却点不预览？
不是插件没装上，而是默认没绑定快捷键，也没自动关联 Markdown 语法类型。装完 MarkdownPreview 后，你得手动触发——按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Markdown Preview: Preview in Browser 回车，才能看到效果。
常见错误现象：Command not found: markdown_preview，说明插件根本没启用，或者安装路径异常（比如用了 Package Control 但网络失败静默跳过）；也可能是文件后缀是 .mdx 或 .markdown，但 Sublime 没识别成 Markdown 语法（右下角显示 “Plain Text”）。
- 确认语法模式：点击右下角文字 → 选
Markdown（不是MultiMarkdown或其他） - 检查插件状态：菜单栏
Preferences → Package Settings → Markdown Preview → Settings，如果能打开，说明已加载 - 别用拖拽方式安装插件 zip 包，
Package Control安装失败时不会报错，只会“假装成功”
为什么 Ctrl+B 预览没反应？
Ctrl+B 是 Sublime 默认的构建系统快捷键，不是 MarkdownPreview 的原生绑定。插件默认不接管这个键位，除非你手动配置。很多人误以为装完就自动支持，结果反复按 Ctrl+B 只弹出“no build system”的提示。
使用场景：快速写作时希望一键刷新浏览器预览，而不是每次调命令面板。这时需要自己加一条键绑定：
[
{
"keys": ["ctrl+b"],
"command": "markdown_preview",
"args": {"target": "browser", "parser":"markdown"}
}
]
注意："parser":"markdown" 表示用内置解析器（快、轻量），若要支持表格、脚注等扩展语法，得换成 "parser":"github" 或 "parser":"mistune"，但会变慢，且需额外依赖。
- 键绑定文件路径是
Preferences → Key Bindings（右侧用户文件） - 别覆盖默认
Ctrl+B构建行为——如果你还写 Python/JS，建议改用Ctrl+Alt+P这类组合避免冲突 -
github解析器依赖网络，离线时会卡住或 fallback 到空白页
预览样式丑、代码块没高亮、数学公式不渲染？
默认预览用的是极简 CSS，连 <pre><code> 都没基础样式，更别说 $$E=mc^2$$。这不是 bug，是插件设计如此：它只负责转 HTML，样式和扩展功能靠配置驱动。
参数差异直接决定输出效果：markdown_extensions 控制解析能力，css" 和 "mathjax 控制渲染表现。例如开启 GitHub 风格表格，就得在用户配置里加：
"markdown_extensions": [
"tables",
"fenced_code",
"codehilite",
"smarty"
]
性能影响明显：加了 codehilite 就要引入 Pygments，首次预览会延迟 1–2 秒；开 mathjax 则必须联网加载 JS，国内用户常卡在 https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js。
- 本地开发想离线用高亮？删掉
codehilite，改用highlightjs+ 下载 JS/CSS 到本地mdpreview目录 - 数学公式只在
github解析器下部分支持，markdown解析器完全不认$$ - Mac 上 Safari 对 MathJax 支持差，建议固定用 Chrome 预览
Sublime 4 升级后预览变慢或崩溃？
Sublime Text 4 对插件 API 做了调整，老版本 MarkdownPreview（v2.x）在 ST4 下会频繁重编译 HTML，CPU 占用飙高，甚至导致标签页假死。这不是你文档大，是插件未适配新 API 的缓存机制。
兼容性影响：ST4 默认启用 hardware_acceleration，而旧版插件生成的 HTML 里含大量内联样式，触发 GPU 渲染 bug，页面滚动卡顿。
- 必须升级到
MarkdownPreviewv3.0+（GitHub 主分支最新版，Package Control 里可能还没同步） - 禁用实时监听：在配置里设
"enable_autoreload": false，改完手动按快捷键，比自动刷稳定得多 - 别在项目根目录放超大图片（如 >5MB PNG），预览时会被 Base64 编码塞进 HTML，内存直接爆
