必须完全退出并重启sublime text；安装时输入markdownpreview（无空格、无s、结尾preview）；右下角状态栏须显示markdown（非plain text或markdown gfm）。
Markdown Preview插件装完没命令？重启+拼写+语法三步锁死
命令面板搜不到 Markdown Preview: Preview in Browser，不是插件没装上，而是启动链断了。必须做三件事：完全退出 Sublime Text 再重开；Package Control 安装时输的是 MarkdownPreview（无空格、无 s、结尾是 Preview）；右下角状态栏显示的是 Markdown（不是 Plain Text 或 Markdown GFM）。Markdown GFM 来自 MarkdownEditing 插件，它和 MarkdownPreview 是两套东西，混用反而容易冲突。
预览空白页或卡住？检查 renderer 和网络依赖
空白页大概率是渲染器配错了。默认配置里 "renderer" 如果没显式设为 "markdown"，插件会尝试用 "github" 后端——这意味着每次保存都要连 GitHub API，网络不通就卡死，且控制台不报错。打开 Preferences → Package Settings → Markdown Preview → Settings，确认有：
{
"renderer": "markdown",
"markdown_extensions": ["extra", "codehilite", "fenced_code", "tables"]
}
"extra" 必须包含，否则表格、脚注、定义列表全不渲染；"codehilite" 是代码块高亮的基础，缺了就是纯灰底白字。
将 Markdown 格式的回复转换为适合 Telegram 的富文本，避免渲染错误。适用于用户偏好 Markdown 但目标平台为 Telegram 的场景。
中文路径下 404 或图片不显示？别改文件名，改配置和路径基准
Windows 下保存在 C:/Users/张三/笔记.md，预览时浏览器地址栏变成 file:///C:/Users/%E5%BC%A0%E4%B8%89/%E7%AC%94%E8%AE%B0.md 然后 404，这不是编码问题，是 Sublime 内部 URL 构造与浏览器解码不一致。最稳解法是把 "enable_autoreload": false 加进配置——禁用自动重载能绕过这个环节。图片路径则严格按 .md 文件所在目录算：如果文件在 /project/docs/intro.md， 就去找 /project/docs/img/logo.png，不是项目根目录。
数学公式和 Mermaid 图表怎么启用？扩展名+开关双生效
公式不是开个开关就行，得配对扩展和解析器："enable_mathjax": true 必须配合 "markdown_extensions" 里加 "pymdownx.arithmatex"（不是 mathjax 或 mdx_math）。Mermaid 同理，要加 "pymdownx.mermaid" 并确保 "pymdownx" 已通过 pip 安装到系统 Python（Sublime 4 自带 Python 不管这事）。如果你用的是 "renderer": "github"，这些扩展全无效——GitHub API 不支持自定义扩展。
最容易被忽略的点：首次必须手动执行一次 Markdown Preview: Preview in Browser，之后的自动刷新才可能生效；所有配置项都只在 Settings - User 里生效，Settings - Default 是只读的；python_binary 字段现在基本不用填，除非你还在用 ST3 或手动替换了 Python DLL。
