sublime text预览markdown必须同时安装markdownediting和markdownpreview插件,缺一不可;仅装前者可高亮但无法预览,仅装后者则语法识别失败、命令不可见;安装后须重启、设语法为markdown gfm、配置parser为github并启用mathjax,否则样式、公式均不渲染。

装完 MarkdownPreview 插件后,预览默认就是生成静态 HTML 文件——它不依赖服务器,也不走网络,直接写入临时目录并用浏览器打开。所谓“静态网页”,正是它的默认行为,不是额外功能,也无需开启特殊开关。
必须同时装 MarkdownEditing 和 MarkdownPreview
只装 MarkdownPreview,.md 文件在 Sublime 里仍是 Plain Text,右下角不显示 Markdown,Markdown Preview: Preview in Browser 命令根本不会出现;只装 MarkdownEditing,能高亮、能快捷插入标题,但点预览会报 command not found: markdown_preview。
- 安装顺序无所谓,但两个都得通过 Package Control 装(别搜 “Markdown Previewer” 或 “OmniMarkupPreviewer”,那些已停更或不兼容)
- 装完必须重启 Sublime,否则插件不加载,命令面板搜不到相关命令
- 打开 .md 文件后,务必点击右下角语言标识 → 选
MarkdownEditing → Markdown GFM,否则 GitHub 表格、任务列表、数学公式等特性不生效
parser 设成 github 才能渲染样式和公式
默认解析器是 markdown,它只转基础语法,不加载 GitHub CSS、不支持 MathJax。如果你预览出来是白底黑字、表格错位、公式显示为原始 LaTeX,说明 parser 没配对。
- 进
Preferences → Package Settings → Markdown Preview → Settings – User - 加这三行(缺一不可):
"parser": "github", "enable_mathjax": true, "github_mode": true
- 注意:
gfmparser 不支持 MathJax,必须用github或markdown配enable_mathjax
快捷键、自动刷新、浏览器路径全得手动配
MarkdownPreview 默认不绑快捷键、不监听保存、不指定浏览器——你按 Ctrl+B 没反应,不是插件坏了,是它压根没接管这个键位。
- 快捷键:进
Preferences → Key Bindings – User,加一行:{"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "github"}} - 自动刷新:设
"enable_autoreload": true,但仅对已保存的本地文件有效;未保存的 untitled 标签页或远程路径不触发 - 浏览器路径:Windows 上若报
Permission denied,改"browser": "default";macOS 若 Safari 空白,临时切"browser": "safari";Chrome 路径含空格时,用正斜杠写成"browser": "C:/Program Files/Google/Chrome/Application/chrome.exe"
预览空白页?先看控制台报什么错误
空白页几乎从不因为插件本身损坏,而是环境或配置断链。打开 View → Show Console,再执行预览,看输出:
-
ImportError: No module named markdown→ 运行pip install markdown(用系统 Python,不是 Sublime 自带的那个) -
UnicodeEncodeError: 'gbk' codec can't encode character→ 文件路径含中文,要么改路径,要么在设置里加"encoding": "utf-8" - 控制台没报错但页面空白 → 检查浏览器是否拦截了本地文件协议(file://)的样式加载,换 Chrome 并确保没开“阻止弹出窗口”
最常被忽略的一点:所有配置项都必须写在 Settings – User 里,而不是 Settings – Default;改错文件等于没改。另外,enable_autoreload 和 LiveReload 是两套机制,后者需额外装插件并手动启用,前者纯靠插件自身轮询,别混用。











