sublime text 的 markdown 编写体验取决于插件配置而非单纯安装：需手动设置语法为 markdown gfm、彻底重启软件、首次手动触发预览，三者缺一不可；否则高亮、快捷键、预览均失效。
Sublime Text 本身不“编写” Markdown，它只编辑文本；所谓“编写体验”好坏，取决于语法高亮是否准确、快捷键是否响应、预览能否稳定触发——而这三件事，全靠插件组合和配置对不对，不是装了就完事。
怎么让 .md 文件一打开就是 Markdown 语法高亮？
右下角显示 Plain Text 是最常见假象，它不代表文件坏了，只说明 Sublime 没把当前文件当 Markdown 处理。即使文件名是 readme.md，只要状态栏没显示 Markdown 或 Markdown GFM，所有后续功能（包括预览）都会静默失效。
- 点右下角文字 → 搜索
Markdown GFM（来自MarkdownEditing插件）→ 选中；若没这个选项，说明插件没装对或没重启 - 想一劳永逸：选中后 → 点右下角 →
Open all with current extension as…→ 再选Markdown GFM - 别用 Sublime 自带的
Markdown语法包：它不支持中文标题高亮、列表缩进错位、代码块无着色；MarkdownEditing才是专为写作优化的语法定义 - 检查是否残留冲突设置：打开
Preferences → Settings – Syntax Specific，删掉类似"syntax": "Packages/Markdown/Markdown.sublime-syntax"的行
为什么装了 MarkdownPreview 却 Ctrl+Shift+P 搜不到命令？
不是插件没装上，而是 Sublime 没加载它——90% 是因为没完全退出再重开。Package Control 安装插件后，命令注册发生在启动阶段，运行中安装只是把文件拷进去，不触发初始化。
WiseOCR — 将 PDF 或图片文件转换为高质量 Markdown 文本，支持表格完整识别、多栏版式还原、中英文混排。适用场景：扫描件文字提取、纸质文档数字化、合同/报告/论文转文本、图片中文字提取。支持格式：PDF、JPG、JPEG、PNG、WEBP、GIF、BMP、TIFF。触发：用户上传文件并要求"帮我识别这个文件的文字"、"PDF转文字"、"图片转文本"、"帮我提取这个表格"——会调用本技能。说"用Wi
- 必须彻底退出 Sublime（Windows/Linux 任务栏右键退出，macOS 菜单栏里 Quit），再重新打开
- 按
Ctrl+`打开控制台，执行import sys; print(sys.version)，确认输出是3.6+（ST4 自带 3.8+，不用额外装 Python） - 别同时装
OmniMarkupPreviewer或旧版Markdown Preview：它们会劫持markdown_preview命令名，导致快捷键失效甚至保存卡住 - 搜命令时输全称：
Markdown Preview: Preview in Browser，不是preview或md preview
怎样让 Ctrl+Alt+M 真正触发浏览器预览？
快捷键默认只在 text.html.markdown 作用域下生效，而这个作用域不会自动绑定到所有 .md 文件——它依赖你手动设过语法，且文件已保存（untitled 临时文件永远不匹配）。
- 先确保右下角显示
Markdown GFM，再按Ctrl+S保存为.md后缀 - 打开
Preferences → Key Bindings – User，粘贴这行（不要删原有内容）：[{"keys": ["ctrl+alt+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "markdown"}}] - 别碰
enable_autoreload：新版（2026 年起）已废弃该配置，设为true反而会让浏览器标签页失焦、mathjax 渲染中断、保存时 Sublime 卡顿 - 首次预览必须手动触发一次：
Ctrl+Shift+P→Markdown Preview: Preview in Browser→ 回车；之后保存才会刷新，这是机制前提，跳不过
预览空白、CSS 不加载、公式不渲染？查这三点
预览页打开但内容为空白，或样式错乱、$$E=mc^2$$ 不转成公式，问题通常不在插件本身，而在路径、协议或配置项写错。
- 看浏览器地址栏 URL：必须是
file://开头（本地文件协议），如果是http://localhost:xxxx或含中文路径（如file:///C:/用户/xxx/文档/readme.md），自动刷新和资源加载大概率失败 - 检查
Preferences → Package Settings → MarkdownPreview → Settings，确认有这些关键项：{ "markdown_extensions": ["extra", "codehilite", "toc", "fenced_code"], "github_mode": true, "enable_highlight": true} - 如果报
No module named 'markdown'：说明装的是 v1.x 旧版，卸载重装MarkdownPreview（注意拼写，无空格、无 s），v2.4+ 已内嵌解析器，不依赖系统pip install markdown
真正卡住人的地方，从来不是“怎么装”，而是“装完没重启”“语法没手动设”“首次没手动预览”这三步被当成可跳过环节——它们不是建议，是硬性前提。
