sublime text 本身不提供 markdown 实时预览能力，所谓“实时在浏览器预览”必须靠 markdownpreview 插件 + 浏览器协同实现；但默认不自动刷新，首次必须手动触发 markdown preview: preview in browser，之后保存才可能刷新——漏掉这步，所有配置都无效。
Sublime Text 本身不提供 Markdown 实时预览能力，所谓“实时在浏览器预览”必须靠 MarkdownPreview 插件 + 浏览器协同实现；但默认不自动刷新，首次必须手动触发 Markdown Preview: Preview in Browser，之后保存才可能刷新——漏掉这步，所有配置都无效。
为什么装了 MarkdownPreview 却找不到命令或点不动？
这不是插件没装好，而是 Sublime 没把它当 Markdown 文件处理，或环境没就位：
- 右下角状态栏必须显示
Markdown（不是Plain text或Markdown GFM），否则插件直接忽略所有命令 - 文件必须已保存，且后缀为
.md或.markdown；untitled标签页永远无法触发预览 - 安装
MarkdownPreview后必须完全退出 Sublime 再重开，否则命令未注册进Ctrl+Shift+P面板 - 别同时装
OmniMarkupPreviewer或旧版Markdown Live Preview，它们会覆盖命令、让右键菜单消失
怎样让保存后浏览器自动刷新？别设 enable_autoreload
这个配置项已在 2026 年起的 MarkdownPreview 版本中废弃。设为 true 不仅无效，还会导致 Sublime 在保存瞬间卡死甚至崩溃（尤其 Windows + ST4）。
Markdown Converter 1.0.0
下载
使用 markitdown 将文档和文件转换为 Markdown。适用于转换 PDF、Word (.docx)、PowerPoint (.pptx)、Excel (.xlsx, .xls)、HTML、CSV、JSON、XML 等格式。
真正起作用的是浏览器端的自动重载机制，它依赖两个硬性条件：
- 必须先手动执行一次
Markdown Preview: Preview in Browser，生成初始 HTML 页面并打开标签页 - 该标签页 URL 必须是
file://协议（如file:///C:/xxx/readme.html）或http://127.0.0.1:xxxx；http://localhost因端口冲突常失败 - Chrome/Edge 用户需关闭设置里的「使用预测服务来加载网页」（
chrome://settings/privacy），否则本地文件刷新被拦截
表格、公式、Mermaid 图表为什么不渲染？
默认解析器 "parser": "markdown" 只支持基础语法，高级特性需要显式启用：
- 表格、任务列表、删除线：改用
"parser": "mistune"（离线可用）或"parser": "github"（需联网 + GitHub token） - 数学公式：加
"enable_math": true，并确保 MathJax CDN 可访问；国内网络建议换 KaTeX 配置 - Mermaid 图表：需额外开启
"enable_mermaid": true，且浏览器要能加载mermaid.min.js（注意跨域限制） - 代码块高亮：
"codehilite扩展依赖 Pygments，而 Sublime 自带 Python 通常没装它；换mistune解析器更省事
最容易被忽略的一点：所有自动刷新行为只对“已打开的预览标签页”生效。新开一个标签页、或从书签直接打开 HTML 文件，都不会响应保存事件——它不是监听文件系统，而是靠插件向特定页面注入 JS 脚本轮询更新。
