必须只装MarkdownPreview插件,拼写为MarkdownPreview(无空格、无s、非Previewer),安装后需重启Sublime、设文件语法为Markdown、保存为.md文件并首次手动预览,才能实现浏览器自动刷新。

只能靠 MarkdownPreview 插件 + 浏览器打开 HTML 实现,没有内置预览窗格,也不支持侧边实时渲染。
装哪个插件?只认 MarkdownPreview
别搜 MarkdownEditing(只管高亮)、OmniMarkupPreviewer(已停更、与 ST4 冲突)、MarkdownLivePreview(多年未维护)。真正起作用的只有 MarkdownPreview:结尾是 Preview,无空格、无 s、不是 Previewer。
- 用
Ctrl+Shift+P→Package Control: Install Package→ 输入MarkdownPreview(注意大小写和拼写) - 安装后必须完全退出 Sublime Text 再重开,否则命令不可见
- 重启后在命令面板输入
mp,应能看见Markdown Preview: Preview in Browser
为什么命令没反应或预览空白?先查这三件事
90% 的失败都卡在这几步,不是插件坏了,而是环境没对齐:
使用 SQLite FTS5 对结构化 Markdown 文档库进行全文搜索,适用于需要快速、高效搜索大量 Markdown 文章的场景。
- 右下角状态栏必须显示
Markdown(不是Plain text或Markdown GFM);点它 → 搜索Markdown→ 选纯Markdown - 文件必须已保存,且后缀为
.md或.markdown;untitled标签页永远不触发预览 - 编码必须是
UTF-8;含中文内容时,若为GBK或带BOM,HTML 解析会静默失败 →File → Reopen with Encoding → UTF-8
怎么让保存后浏览器自动刷新?手动触发是硬前提
所谓“自动刷新”不是保存就动,而是依赖已打开的浏览器标签页主动 reload —— 这个标签页必须由插件首次生成:
- 必须先手动执行一次
Markdown Preview: Preview in Browser,生成初始 HTML 页面 - 之后每次保存,只要该标签页没关,就会自动刷新(前提是 URL 以
file://或http://127.0.0.1开头) -
"enable_autoreload": true已被移除,2026 年起设了反而导致卡死或崩溃,直接删掉 - Chrome / Edge 用户若刷新失效,检查是否启用了“阻止第三方 Cookie”或“严格隔离”,临时禁用即可
表格、公式、Mermaid 怎么启用?靠配置项,不是默认开
基础解析器 "parser": "markdown" 只支持最简语法,要渲染高级特性得显式配置:
- 表格/脚注/TOC:加到
"markdown_extensions"里,如["tables", "fenced_code", "toc"] - 数学公式:设
"enable_math": true,并确保 MathJax CDN 可访问(离线建议换 KaTeX) - Mermaid 图表:需额外加
"pymdownx.superfences"扩展,并在代码块前写```mermaid - 中文路径报
404?Windows 下避免路径含中文或空格,比如改用C:\md\test.md
最容易被忽略的点:所有配置生效的前提,是文件已被 Sublime 正确识别为 Markdown 语法,且首次预览已由插件手动触发——跳过这两步,后面加再多配置也没用。

















