装对插件、设对语法、手动触发一次预览三步缺一不可；命令面板搜不到是因未重启sublime或语法未识别为markdown，右下角须显示markdown，文件须保存为.md/.markdown后缀，且不能与markdownediting等插件冲突。
装对插件、设对语法、手动触发一次预览，三步做完就能用；其他所有配置都是锦上添花，缺一不可。
为什么命令面板搜不到 Markdown Preview: Preview in Browser
不是插件没装，是 Sublime 没重启或语法没识别。命令注册依赖完整启动流程，且只响应当前语法为 Markdown 的文件。
- 安装
MarkdownPreview后必须完全退出 Sublime Text 再重开（不是关闭标签页，是杀进程） - 右下角状态栏必须显示
Markdown—— 点它 → 搜索Markdown→ 选中纯Markdown（不是Markdown GFM或Plain text） - 文件必须已保存，后缀为
.md或.markdown；untitled标签页永远不触发预览 - 别装
MarkdownEditing或OmniMarkupPreviewer，它们和MarkdownPreview冲突，会导致命令消失或右键菜单异常
预览打开空白页或 404 是什么问题
大概率是解析器没配对、路径含中文、或浏览器策略拦截了 reload 脚本。
- 默认
renderer是github，但网络不通时静默失败；改用"renderer": "markdown"可离线解析 - Windows 中文路径（如
C:\用户\张三\笔记.md）会被 URL 编码截断，导致浏览器 404；临时解法是移到D:/md/这类纯英文路径 -
enable_autoreload在 2026 年已废弃，设为true反而卡死；新版靠浏览器原生 reload，只要首次用Markdown Preview: Preview in Browser打开，后续保存就会刷新 - 图片不显示？路径是相对于
.md文件位置算的，表示找同目录下的images/logo.png，不是项目根目录
怎么让表格、数学公式、代码高亮正常渲染
基础 markdown 解析器只支持最简语法，扩展得靠显式启用，且部分依赖外部库。
- 表格、任务列表、删除线：把
"parser"改成"mistune"（离线可用），或加"markdown_extensions": ["tables", "fenced_code", "toc"] - 数学公式：加
"enable_math": true和"mathjax_enabled": true；若 MathJax CDN 被墙，需换本地 KaTeX 路径 - 代码块高亮：
codehilite依赖Pygments，而 Sublime 自带 Python 不含该包；推荐直接用mistune解析器，它自带轻量高亮 - Mermaid 图表：需额外加
"pymdownx.superfences"到markdown_extensions，并确保pymdownx已安装
最容易被忽略的是：首次预览必须手动走命令面板触发，之后保存才自动刷新；所有“实时”效果都建立在这个前提上，跳过就白配。
