Sublime Text需通过Package Control安装MarkdownEditing和Markdown Preview插件实现Markdown功能；安装后需配置构建系统、浏览器预览及缓存策略以解决Ctrl+B无效、预览不更新、Safari样式丢失等问题。

Sublime Text 怎么通过 Package Control 安装 Markdown 插件

Sublime Text 本身不内置 Markdown 渲染能力，必须靠插件实现语法高亮、快捷键和预览功能。最可靠的方式是用 Package Control 安装官方维护的 MarkdownEditing（增强编辑体验）和 Markdown Preview（生成 HTML 预览）。

前提是已安装 Package Control —— 如果没装，先用 Ctrl+` 调出控制台，粘贴官方安装脚本（Python 3 版本），回车执行；成功后重启 Sublime。

• 按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Install Package，回车
• 等待列表加载完成，依次输入并选择安装：MarkdownEditing → Markdown Preview
• 安装完不用重启，但建议新建一个 .md 文件测试：输入 # Hello，看是否自动高亮

Markdown Preview 怎么配置浏览器实时预览

Markdown Preview 默认用本地文件协议打开 HTML，部分浏览器（如 Chrome）会因安全策略拒绝加载样式或图片。这不是插件 bug，而是浏览器限制。

Markitdown Hosted Markdown Generator

MarkItDown 托管 Markdown 生成器：可将文件转换为 Markdown。支持 PDF、Word (.docx)、Excel (.xlsx/.xls)、PowerPoint (.pptx)、HTML、CSV、JSON、XML、图片等。

下载

• 预览前确保文件已保存（未保存的临时文件无法正确解析路径）
• 推荐使用 python -m http.server 8000 启一个本地服务，再在插件设置里把 "browser": "chrome" 改为 "browser": "custom"，并指定 "custom_browser": "http://localhost:8000/{file_path}"
• 更简单的方法：直接用快捷键 Ctrl+Shift+P → 输入 Markdown Preview: Preview in Browser，首次会生成带内联样式的 HTML 并用默认浏览器打开（CSS 是 base64 编码嵌入的，不受跨域影响）

为什么 Ctrl+B 不生效或预览内容不更新

这是最常见的两个问题，根源都在构建系统和缓存机制上。

• Ctrl+B 是 Sublime 的“构建”快捷键，默认绑定到当前语法对应的构建系统；Markdown 没有默认构建系统，所以必须手动绑定：菜单栏 Tools → Build System → New Build System，填入：

  {
    "cmd": ["python", "-m", "markdown", "$file", "-f", "$file.html"],
    "selector": "source.gfm, source.md",
    "file_regex": "^(...*?):([0-9]+):?([0-9]+)?:? (.*)$"
  }

  保存为 Markdown.sublime-build，再在 Build System 中选它
• 预览内容不更新，大概率是 Markdown Preview 缓存了旧 HTML。可手动删掉同目录下的 *.md.html 文件，或在插件设置中开启 "enable_autoreload": true（需配合 LiveReload 浏览器插件）
• 注意：如果用了 MarkdownEditing，它会把语法切换成 Markdown GFM，而原生 Markdown 语法可能不触发预览，务必确认右下角状态栏显示的是 GFM 或 Markdown

Mac 上用 Safari 预览时样式丢失怎么办

Safari 对本地 file:// 协议限制极严，连 @import 和字体文件都会被拦截，导致预览页只有文字没有排版。

• 不要双击打开生成的 .html 文件，而是用命令行：open -a "Safari" /path/to/file.html，有时能绕过部分限制
• 更稳的方案：改用 Markdown Preview 的 Save to Disk 功能（Ctrl+Shift+P → Markdown Preview: Save to Disk），再拖拽该 HTML 到 Chrome/Firefox 中打开
• 终极解法：在插件设置中启用 "include_css": true 和 "include_js": true，确保所有依赖都打包进单个 HTML 文件，避免外部资源请求

真正卡住的地方往往不是插件装没装，而是浏览器策略、文件路径解析、语法模式匹配这三者没对齐。调试时先看右下角语法标识，再查控制台有没有 File not found 或 CSS failed to load 报错，比重装插件快得多。