Sublime Text安装Markdown实时预览插件方法-sublime-PHP中文网

sublime text 本身不支持 markdown 实时预览，必须组合安装 markdown preview 和 livereload 插件：前者负责 html 渲染，后者监听文件变化并自动刷新浏览器；仅装前者只能手动预览，不构成实时流程。

sublime text安装markdown实时预览插件方法

Sublime Text 本身不支持 Markdown 实时预览，必须靠插件组合实现——Markdown Preview 负责渲染 HTML，LiveReload 负责监听文件变化并刷新浏览器，两者缺一不可。只装 Markdown Preview 只能手动触发预览，谈不上“实时”。

安装 Package Control 是前提，不是可选项

所有插件都依赖它，跳过这步后续全部失败。别信“直接拖文件进 Packages 目录”的野路子，容易权限错、路径错、版本错。

按 Ctrl + `（Windows/Linux）或 Cmd + `（Mac）打开控制台，粘贴官方命令（2026 年仍有效）：
import urllib.request,os,hashlib; h = '6f4c264a24d933ce70df5dedcf1dcaee' + 'ebe013ee18cced0ef93d5f746d80ef60'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); by = urllib.request.urlopen('http://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download (got %s instead of %s), please try manual install' % (dh, h)) if dh != h else open(os.path.join(ipp, pf), 'wb').write(by)
执行后没报错、没提示 “Error validating download”，且重启 Sublime 后 Preferences → Package Control 菜单项存在，才算成功
如果控制台报 urlopen error [Errno 110] Connection timed out，说明网络被拦截，需配代理或换源（比如把 http://packagecontrol.io/ 改成 https://sublime.wbond.net/）

必须装的两个插件：Markdown Preview + LiveReload

网上很多教程推荐 MarkdownLivePreview，但它已多年未更新，与 Sublime Text 4+ 兼容性差，保存后不刷新、中文乱码、数学公式崩塌——2026 年起强烈建议弃用。

Markdown to PDF (Styled)

使用pandoc和wkhtmltopdf将Markdown文件转换为带样式的PDF，支持内置或自定义CSS样式。

下载

按 Ctrl + Shift + P（Win/Linux）或 Cmd + Shift + P（Mac），输入 Package Control: Install Package 回车
依次搜索并安装：Markdown Preview、LiveReload（注意拼写，不是 LiveReload Plugin 或 LiveReload ST3）
装完不用重启，但首次启用 LiveReload 前必须手动开启：再按 Ctrl + Shift + P，输入 LiveReload: Enable/disable plug-ins，选 Simple Reload with delay (400ms) ——这个延迟能避免快速连敲时多次刷新

关键配置项：enable_autoreload 和 parser

Markdown Preview 默认关闭自动重载，LiveReload 也默认不接管本地文件，不调这两项等于白装。

打开 Preferences → Package Settings → Markdown Preview → Settings – User

填入以下最小必要配置（别复制 Default 全部内容，容易冲突）：

{
  "enable_autoreload": true,
  "parser": "markdown",
  "markdown_extensions": ["extra", "codehilite", "fenced_code", "tables", "admonition"]
}

"parser": "markdown" 表示用 Python-Markdown 渲染，比 "github" 更可控；若要支持 Mermaid 图表，得额外装 python-markdown-mermaid 并加到 markdown_extensions
如果预览页空白，检查浏览器控制台是否报 net::ERR_FILE_BLOCKED ——这是 Chrome 89+ 默认禁止本地 file:// 协议加载 JS，解决方案是启动 Chrome 时加参数：chrome --unsafely-treat-insecure-origin-as-secure="file:///" --user-data-dir=/tmp/chrome-test

快捷键和工作流：别依赖鼠标点菜单

每次写文档都要去菜单里点 “Preview in Browser”？效率太低。绑定快捷键 + 设置自动语法识别才是日常节奏。

在 Preferences → Key Bindings 的右侧栏（User）加一行：
{"keys": ["alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "markdown"}}
新建文件后，按 Ctrl + Shift + P 输入 Set Syntax: Markdown，或保存为 .md 后缀，Sublime 自动识别语法高亮
真正“实时”的前提是：文件已保存（auto-save 插件可设为每秒保存）、浏览器标签页已打开、且该页面 URL 是 file:// 开头（不是 http://localhost）——否则 LiveReload 刷新无效

最容易被忽略的一点：Sublime 的 Markdown Preview 渲染结果和 GitHub 风格不完全一致，比如任务列表、脚注、自定义容器等扩展语法，默认不启用。需要什么效果，得查清对应 markdown_extensions 名称并显式开启，而不是指望“装了就和 GitHub 一样”。