sublime text 安装 markdown 插件需先正确安装并重启 package control，再同时安装 markdownpreview 和 markdownediting；须手动配置快捷键、自动刷新、浏览器路径及 http server 模式以解决预览问题。
Package Control 装不上就别硬试
Sublime Text 里装 Markdown 插件，第一步不是搜 MarkdownPreview，而是确认 Package Control 已正确安装。很多人卡在这步：手动下载 package_control.sublime-package 放进 Packages/Installed Packages/，但没重启 Sublime，或者放错路径（比如放进 Packages/ 根目录而非 Installed Packages/）。结果是 Ctrl+Shift+P 呼出命令面板后搜不到 Install Package。
实操建议：
- 用官方推荐的一行 Python 安装脚本（官网最新版为准），粘贴进 Sublime 的
View → Show Console，回车执行 - 执行完必须重启 Sublime，否则
Package Control不生效 - 重启后按
Ctrl+Shift+P，输入Package Control: Install Package，能响应才算成功
MarkdownPreview 和 MarkdownEditing 要一起装
只装 MarkdownPreview，你只能“预览”，但编辑体验极差：没有语法高亮、标题缩进不明显、代码块没配色。而只装 MarkdownEditing，又没法实时看渲染效果。两者定位不同，缺一不可。
常见错误现象：
- 装了
MarkdownPreview却发现 .md 文件还是白底黑字——没装MarkdownEditing，Sublime 没把文件识别为 Markdown - 装了
MarkdownEditing后右键没“Preview in Browser”选项——MarkdownPreview没装或没启用 - 预览时数学公式不渲染、表格错位——默认用的是 GitHub 风格解析器，但没开
github_css或github_mode
预览快捷键和配置得手动调
MarkdownPreview 默认不绑定快捷键，也不会自动监听文件保存。想实现“改完就刷浏览器”，得自己配。而且它的默认行为是生成静态 HTML 写入临时目录，不是真正意义上的“实时热更新”。
实操建议：
- 给预览加快捷键：在
Preferences → Key Bindings里添加：[{"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser":"github"}}] - 开启自动刷新：在
Preferences → Package Settings → Markdown Preview → Settings中加入："enable_autoreload": true
（注意：仅对本地文件有效，远程路径或未保存文件不触发） - 避免中文路径问题：如果预览报错
UnicodeEncodeError，说明文件路径含中文，要么改路径，要么在设置里加"encoding": "UTF-8"
Mac / Windows 下浏览器打开行为不一致
Windows 默认用 IE（老版本）或 Edge 打开预览页，常因安全策略阻止本地 HTML 的 JS 加载（比如 KaTeX 渲染失败）；Mac 上 Safari 对本地 file:// 协议限制更严，Chrome 相对友好但需额外参数启动。
性能与兼容性影响：
- 不用系统默认浏览器：在
Markdown Preview设置里指定 Chrome 路径，例如 Windows："browser": "chrome"
，Mac："browser": "google-chrome"
（需已安装并加入 PATH） - 若用 Chrome，建议加启动参数避免跨域问题：
"chrome_args": ["--allow-file-access-from-files"]
（新版 Chrome 已弃用该参数，此时需改用本地 HTTP server 模式） - 真要“实时”，不如直接用
MarkdownPreview的http_server模式（设"enable_http_server": true
），它起一个本地 8080 端口服务，绕过所有 file:// 限制
容易被忽略的点是：HTTP Server 模式下，预览地址变成 http://127.0.0.1:8080/xxx.html，不是 file:///xxx.html，这意味着所有相对路径引用（比如图片）必须符合 Web 路径规则，而不是文件系统路径。
