sublime text便携版需手动配置packages路径、确保预览url为file:///协议、关闭chrome预测服务,且所有路径禁用中文与空格,才能实现markdown实时预览。

Sublime Text 便携版(Portable)能实现 Markdown 文档实时预览,但必须绕过两个默认限制:插件安装路径不固定、浏览器自动刷新在 file:// 协议下更脆弱。它和普通安装版原理一致,但每一步都更容易卡在“看似装好了却没反应”上。
便携版装 MarkdownPreview 插件必须改 Packages 路径
便携版不会把插件装进系统级目录,而是默认用 Packages/ 子文件夹——但 Package Control 不一定自动识别这个位置。
- 启动 Sublime 便携版后,先按
Ctrl+`打开控制台,输入:import sublime; print(sublime.installed_packages_path())
确认输出路径是否指向你便携版的Data/Packages/目录(比如C:\sublime-portable\Data\Packages) - 如果输出是空或指向其他位置,说明 Package Control 没识别便携环境,需手动设置:
菜单 →Preferences → Browse Packages…,关闭 Sublime,把Package Control.sublime-package文件复制到正确的Data/Installed Packages/下(不是Packages/) - 重启后再次运行上述命令,确保路径正确,再通过
Package Control: Install Package安装MarkdownPreview(注意拼写,无空格、无 s、不是 Previewer)
首次预览必须手动触发,且浏览器 URL 必须是 file://
便携版生成的 HTML 是本地文件,浏览器只允许 file:// 协议下的自动刷新;一旦 URL 变成 http://localhost 或含中文路径,刷新立即失效。
- 打开一个已保存的
.md文件(不能是untitled),右下角状态栏点击 → 选Markdown(不是Markdown GFM或Plain text) - 按
Ctrl+Shift+P→ 输入Markdown Preview: Preview in Browser→ 回车,等待浏览器弹出新标签页 - 检查地址栏:必须以
file:///开头,且路径中不能有中文(如file:///D:/我的文档/readme.md会失败,应改为D:/docs/readme.md) - 之后每次保存,只要这个标签页保持打开,就会自动刷新——不需要任何配置项,也不依赖
enable_autoreload
Chrome/Edge 用户必须关掉预测加载功能
便携版常在非标准路径运行,Chrome 的「使用预测服务来加载网页」策略会主动拦截 file:// 页面的 WebSocket 和重载请求,导致保存后页面静止不动。
- 打开
chrome://settings/privacy(或edge://settings/privacy) - 找到「使用预测服务来加载网页」选项,**关闭它**
- 重启浏览器,再试一次预览流程
- 如果仍不刷新,可临时换 Firefox 测试——它对
file://更宽容,无需额外设置
便携版最易被忽略的一点:所有路径(Sublime 安装目录、.md 文件路径、图片相对路径)都不能含中文或空格;哪怕只在一个环节出现,预览就可能空白、公式不渲染、图片 404——这不是插件问题,是浏览器安全策略的硬性限制。











