必须同时安装markdownediting和markdownpreview插件，缺一不可；package control未装好则后续全失败，需用官网python脚本安装并重启sublime；.md文件须手动设为markdown gfm语法，否则白底黑字；预览异常多因浏览器路径含空格或python环境缺失，应配"browser": "default"及卸载重装插件；数学公式、快捷键、自动刷新等功能须在settings–user中手动配置。

必须装 MarkdownEditing 和 MarkdownPreview，缺一不可；Package Control 没装好，后面全白搭。

Package Control 装没装成功，三秒就能验

按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Package Control: Install Package。能立刻弹出包列表，才算真正就位。

• 如果命令灰色、无响应、或报 command not found，说明安装失败
• 别点菜单里那个 Preferences → Install Package Control——Sublime Text 4 早删了这选项
• 必须用官网最新 Python 3 脚本：按 Ctrl+` 打开控制台，粘贴 packagecontrol.io/installation 上的代码，一次性回车执行
• 控制台输出 Package Control: Installed 1 package 后，必须彻底退出 Sublime 再重开，否则命令面板不注册
• 国内用户若卡在 Loading packages，可临时把脚本里的 packagecontrol.io 替成 packagecontrol.cn

只装 MarkdownEditing 或只装 MarkdownPreview 都不行

这两个插件职责完全分离：

Markdown-UI DSL: Zero-Hallucination UI Generation

使用 Markdown-UI DSL 创建低保真文本线框图。

下载

• 没装 MarkdownEditing：.md 文件打开就是 Plain Text，标题不着色、列表无缩进、代码块无配色
• 没装 MarkdownPreview：Ctrl+Shift+P 里搜不到 MarkdownPreview: Preview in Browser，写完只能靠脑补渲染效果
• 拼写必须严格：MarkdownEditing（带 ing），不是 MarkdownEditor；MarkdownPreview（无空格），不是 Markdown Preview
• 装完不用重启，但必须手动绑定语法：打开任意 .md 文件 → 点右下角当前语言名（如显示 Plain Text）→ 选 MarkdownEditing → Markdown GFM
• 想永久生效：菜单 View → Set Syntax → Open all with current extension as… → 再选 Markdown GFM

预览打不开、弹空白页、报 [Errno 13] Permission denied

这不是插件坏了，而是系统拦截了浏览器调用，尤其 Windows 用户最常见：

• 典型错误路径：C:\Program Files\Google\Chrome\Application\chrome.exe —— 空格直接触发权限拒绝
• 最稳解法：打开 Preferences → Package Settings → MarkdownPreview → Settings – User，加一行："browser": "default"
• 非要指定 Chrome：路径改用正斜杠 + 无空格路径，例如 "browser": "C:/Chrome/chrome.exe"
• macOS 预览空白？先关 Safari / Chrome 的「阻止弹出窗口」，或临时设 "browser": "safari"
• 控制台报 ImportError: No module named markdown？新版 MarkdownPreview v2.4+ 已内嵌解析器，卸载重装即可，无需额外 pip install markdown

实时预览要加 LiveReload，别信 MarkdownLivePreview

仅装 MarkdownPreview 只能手动触发预览，不构成“实时”流程：

• 必须额外装 LiveReload（注意拼写，不是 LiveReload Plugin 或 LiveReload ST3）
• MarkdownLivePreview 已多年未更新，与 Sublime Text 4+ 兼容性差，保存后不刷新、中文乱码、数学公式崩塌——2026 年起强烈建议弃用
• 装完 LiveReload 后，首次启用需手动开启：Ctrl+Shift+P → 输入 LiveReload: Enable/disable plug-ins → 选 Simple Reload with delay
• 预览内容不更新？可能是缓存旧 HTML，可手动删同目录下的 *.md.html 文件，或在 MarkdownPreview 设置中开启 "enable_autoreload": true（需配合浏览器端 LiveReload 插件）

最容易被忽略的是：装完插件不手动设语法，等于白装；浏览器路径含空格不处理，预览必然失败；还有人把 MarkdownEditing 拼成 MarkdownEditor，搜半天找不到——这些细节卡住的人，比不会装 Package Control 的还多。