sublime text 无原生 markdown 实时预览,需靠 markdownpreview 插件模拟:须确保右下角语法为 markdown、文件已保存为 .md、python 版本 ≥3.3;启用 enable_autoreload 后需先手动触发 preview in browser,且浏览器 url 必须为 file:// 或 http://127.0.0.1:// 开头,否则无法自动刷新。

Sublime Text 没有原生 Markdown 实时预览能力,所谓“实时”只是靠插件模拟——装对插件、设对语法、配对参数,才能让保存动作触发浏览器刷新;否则你按烂快捷键也看不到效果。
MarkdownPreview 插件装完没反应?先查这三件事
多数人卡在这一步,不是插件没装好,而是环境没就位:
- 右下角状态栏必须显示
Markdown,不是Plain Text或Text;点它 →Set Syntax → Markdown(推荐选Markdown (GitHub flavored)) - 文件必须已保存为
.md后缀,且内容非空——空文件或未保存时,Markdown Preview: Preview in Browser命令会静默失败 - Sublime 控制台(
Ctrl+`)里执行import sys; print(sys.version),输出得是3.3+;ST4 用户一般没问题,ST3 用户若报错,得重装官方最新版
为什么改了内容不自动刷新?enable_autoreload 不是万能开关
"enable_autoreload": true 只在特定条件下生效,不是打开就“实时”:
将 Markdown 格式的回复转换为适合 Telegram 的富文本,避免渲染错误。适用于用户偏好 Markdown 但目标平台为 Telegram 的场景。
- 必须先手动执行一次
Markdown Preview: Preview in Browser,插件才会在浏览器中注入刷新脚本 - 浏览器标签页 URL 必须是
file://或http://127.0.0.1:开头;用双击打开临时 HTML 文件,或拖进浏览器,都不行 - Chrome/Edge 用户要关掉
chrome://settings/privacy里的「使用预测服务来加载网页」,否则本地file://刷新会被拦截 - 该选项在 Windows 中文路径下极易失效——把文件移到
C:\md\这类纯英文无空格路径再试
图片不显示、公式乱码、代码块没高亮?parser 和依赖没配对
默认渲染器 "parser": "markdown" 功能有限,很多特性得显式开启:
- 数学公式需在用户设置里加
"enable_math": true,且页面中写$$E=mc^2$$才生效 - Mermaid 图表要额外启用:
"enable_mermaid": true,并确保浏览器支持 ES6(旧版 IE 不行) - 代码块高亮依赖
pygments:终端运行pip install pygments,再在设置里开"enable_pygments": true - 想用 GitHub 样式?设
"parser": "github",但离线时会 fallback 到基础解析器,样式差异明显
真正容易被忽略的是:Sublime 的“实时预览”本质是「保存 → 触发插件生成 HTML → 推送刷新指令」,中间任何一环断开(语法识别失败、路径含中文、浏览器策略拦截、插件未首次初始化),都会表现为“没反应”。别怪插件不灵,先看控制台有没有 ImportError 或 Permission denied——那才是问题真正的起点。










