Sublime Text 本身不支持 Markdown 实时预览,必须通过 MarkdownPreview 插件配合浏览器模拟实现;需确保文件语法识别为 Markdown、首次手动触发预览、保存后才可自动刷新,且插件安装后必须重启 Sublime。

Sublime Text 本身不支持 Markdown 实时预览,所谓“实时”必须靠 MarkdownPreview 插件 + 浏览器配合模拟;装错插件、语法未设为 Markdown、没手动触发首次预览,这三步出错,90% 的失败就发生了。
怎么确认当前文件被识别为 Markdown?
右下角状态栏显示什么,Sublime 就按什么语法处理文件——哪怕文件名是 readme.md,如果那里写着 Plain text,MarkdownPreview 就不会响应任何命令。
- 点击右下角文字 → 搜索
Markdown→ 选中Markdown(不是Markdown GFM或其他变体) - 想一劳永逸?打开一个
.md文件后,右下角点击 →Open all with current extension as…→Markdown - 未保存的临时文件(如
untitled)永远无法触发预览,务必先Ctrl+S保存为.md后缀
为什么装了 MarkdownPreview 却找不到命令?
常见原因不是插件没装好,而是 Sublime 没重启,或装了冲突插件(比如同时有 OmniMarkupPreviewer 或旧版 Markdown Preview)。
通过 jina.ai 将网页抓取为精简的 markdown,用于在需要获取 URL 并获取压缩的 markdown 内容以节省 token。触发词 l...
- 安装完
MarkdownPreview后必须完全退出 Sublime 再重开,否则Ctrl+Shift+P里搜不到命令 - 用
Ctrl+`打开控制台,输入import sys; print(sys.version),确认输出 Python 版本 ≥3.3(ST4 自带3.8+,无需额外装 Python) - 别碰
enable_autoreload:该配置项已在新版MarkdownPreview中废弃,强行写入会导致自动刷新失效
怎样让保存后浏览器自动刷新?
它不是“保存就刷新”,而是“先手动打开一次预览页,之后保存才触发刷新”——这个前提漏掉,所有配置都白搭。
- 首次必须手动执行:
Ctrl+Shift+P→ 输入Markdown Preview: Preview in Browser→ 回车 - 浏览器会以
file://协议打开 HTML 页面;若 URL 是http://localhost:xxxx或含中文路径,自动刷新大概率失败 - 刷新依赖浏览器原生能力,不用装 LiveReload 扩展,也不用改
mathjax_enabled等参数来启用基础刷新 - 快捷键可自定义:在
Preferences → Key Bindings里加一行{"keys": ["alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser":"markdown"}}
哪些效果本来就不该渲染?
别把 Sublime 当 Typora 或 Obsidian——MarkdownPreview 渲染的是标准 CommonMark + GitHub Flavored Markdown 子集,很多“所见即所得”特性它压根不支持。
-
<details><summary>标签、自定义 CSS、部分内联 HTML 属性(如style="color:red")默认不生效 - 表格对齐仅靠空格/制表符无法渲染,必须用合法的 GFM 表格语法(
|---|分隔线) - 数学公式需显式启用:
"enable_math": true,且页面加载时必须联网访问 MathJax CDN(离线环境会空白)
最常被忽略的一点:自动刷新只作用于已打开的预览标签页,如果你关掉它再保存,下次还得手动触发;也没法跨浏览器同步,Chrome 打开的页面,Edge 不会跟着刷。

















