必须将.md文件语法手动绑定为MarkdownEditing/Markdown GFM，并保存文件，才能启用GFM特性、快捷键和预览功能；系统自带Markdown语法不支持表格、任务列表等，且预览依赖已保存文件。

为什么 .md 文件打开还是 Plain Text 或默认 Markdown？

这不是插件没装好，是 Sublime 没把文件“认”成 MarkdownEditing 管理的语法。系统自带的 Packages/Markdown/Markdown.sublime-syntax 会优先接管 .md 文件，而它不支持 GFM 表格、任务列表、代码块语言识别等关键特性。

必须手动覆盖绑定：

• 打开任意 .md 文件，点击右下角当前语法名（如 Plain Text 或 Markdown）
• 选 Open all with current extension as… → 找到并选择 MarkdownEditing/Markdown GFM（注意：不是 Markdown，也不是 Markdown Extended）
• 永久生效需补配置：菜单 Preferences → Settings – Syntax Specific，右侧加一行：{"extensions": ["md", "markdown"]}
• 写错成 extension（少个 s）或路径里带 .tmLanguage（Sublime 4+ 已废弃），都会导致高亮失效

Ctrl+B / Ctrl+1 快捷键没反应？检查语法和冲突

这些快捷键只在 Markdown GFM 语法下激活。如果右下角显示的是 Markdown（系统自带）或 Plain Text，按键就完全没意义。

常见卡点：

• 确认右下角状态栏显示的是 MarkdownEditing/Markdown GFM，不是其他变体
• 禁用或卸载旧插件如 OmniMarkupPreviewer 或 Markdown Preview（v1.x），它们会抢走 Ctrl+Shift+P 和预览命令绑定
• 加粗用 Ctrl+B（Win/Linux）或 Cmd+B（macOS），别用 Ctrl+I——那是系统斜体，会破坏 Markdown 解析逻辑
• 插入标题直接按 Ctrl+1～Ctrl+6（数字键区，非小键盘），光标必须在行首才生效

表格对齐失败：Table Editor 依赖正确语法上下文

Table Editor 插件不会在 Plain Text 或系统 Markdown 模式下工作，对齐命令会灰掉或乱码。

Telegram Markdown Adapter

将 Markdown 格式的回复转换为适合 Telegram 的富文本，避免渲染错误。适用于用户偏好 Markdown 但目标平台为 Telegram 的场景。

下载

确保：

• 右下角是 MarkdownEditing/Markdown GFM
• 光标落在表格行内（哪怕只是某单元格里），再按 Ctrl+Alt+T（Win/Linux）或 Cmd+Alt+T（macOS）执行 Format Table
• 单元格中含未转义的竖线 | 会被误解析，用反引号包裹：`| inside code |`
• 不要混用缩进式列表和表格在同一段落——语法解析器会丢弃后续内容

预览空白或不刷新？MarkdownEditing 本身不提供预览能力

MarkdownEditing 只负责语法高亮、快捷键和代码片段；想看渲染效果，必须配 MarkdownPreview（注意拼写，结尾是 Preview，不是 Previewer）。

关键限制：

• 所有预览行为都建立在“文件已保存”基础上。没保存的编辑内容，任何预览工具都看不到
• Ctrl+Shift+M 默认无绑定，需手动在 Preferences → Key Bindings – User 中添加：{"keys": ["ctrl+shift+m"], "command": "markdown_preview", "args": {"target": "browser", "parser": "github"}}
• "enable_autoreload": true 在新版 MarkdownPreview（2026 年起）中已废弃，强行写入会导致保存卡顿甚至崩溃
• 中文路径、未设 UTF-8 编码、或浏览器启用了 strict MIME 类型检查，都可能导致预览空白

最容易被忽略的是：语法绑定和文件保存这两步，缺一不可。很多人反复重装插件，其实只是没点右下角那一下，也没按过 Ctrl+S。