MarkdownEditing 插件需手动绑定语法为“Markdown GFM”并配置扩展名，否则快捷键、高亮等功能均失效；预览需搭配MarkdownPreview等独立插件，且须注意配置兼容性与路径问题。
装完 MarkdownEditing 插件不等于能用——它默认不接管任何文件，也不自动高亮、不响应快捷键，必须手动覆盖语法绑定和关闭原生干扰，否则标题无色、列表缩进错位、Ctrl+1 按了没反应都是常态。
为什么 .md 文件打开还是 Plain Text 或原生 Markdown？
Sublime Text 4 默认把 .md 关联到极简的 Packages/Markdown/Markdown.sublime-syntax，而 MarkdownEditing 提供的是独立语法定义（叫 Markdown GFM），两者互不兼容。不手动切换，插件就等于没装。
- 临时解决：打开任意
.md文件 → 右下角点击当前语法名（如 “Plain Text”）→ 选Open all with current extension as…→ 找到并选择Markdown GFM（注意不是 “Markdown” 或 “Markdown Extended”） - 永久生效：菜单栏
Preferences → Settings – Syntax Specific，在右侧用户设置中添加：{"extensions": ["md", "markdown", "mdown", "mkd"]} - 验证是否成功：光标放在行首按
Ctrl+1，应自动生成#；若无反应，右下角显示的不是Markdown GFM，说明绑定失败
快捷键失效或行为异常的常见原因
MarkdownEditing 的快捷键只在 Markdown GFM 语法作用域下生效，且部分组合键与系统或其它插件冲突。最常踩的坑是加粗/斜体不起作用，或标题插入后缩进错乱。
使用 markitdown 将文档和文件转换为 Markdown。适用于转换 PDF、Word (.docx)、PowerPoint (.pptx)、Excel (.xlsx, .xls)、HTML、CSV、JSON、XML 等格式。
-
Ctrl+B/Ctrl+I失效：确认当前语法是Markdown GFM；若仍无效，检查是否被其它插件劫持——打开Preferences → Key Bindings，搜索bold或italic，看是否有重复绑定 -
Ctrl+1～Ctrl+6插入标题无效：必须满足两个条件——光标在行首、该行为空；若行尾有空格或不可见字符，也会失败 -
Ctrl+Shift+K插入代码块后语言标识不识别：确保光标在行首；生成的```后直接敲语言名（如python），不要留空格，否则高亮引擎无法匹配
预览功能不在 MarkdownEditing 职责范围内
MarkdownEditing 只负责编辑体验：语法高亮、快捷键、代码片段。它不提供任何预览能力，也永远不会支持“内嵌 HTML 面板”或自动刷新。想看渲染效果，必须搭配 MarkdownPreview 这类独立插件，并注意配置隔离。
- 别同时启用
MarkdownPreview和OmniMarkupPreviewer，它们会争夺Ctrl+Shift+P命令和右键菜单，导致预览命令消失 -
MarkdownPreview的parser参数只能是"github"或"markdown"；填"gfm"或"commonmark"会静默失败，预览空白 - 预览前必须先保存文件；中文路径或未保存状态会导致
No module named 'markdown'报错（新版已内嵌解析器，此错误只出现在旧版残留）
表格对齐、主题适配等进阶问题
表格不是 MarkdownEditing 的能力范围，主题兼容性也容易被忽略——有些配色方案（如 Monokai）对它的 scope 支持不全，导致代码块或标题颜色异常。
- 表格对齐请用
Table Editor插件：光标落在表格任意单元格内 →Ctrl+Shift+P→ 输入Align Table回车；若命令不可见，先确认语法是Markdown GFM - 换主题验证高亮是否正常：命令面板输入
UI: Select Color Scheme→ 临时切到Adaptive主题，若此时标题变色了，说明原主题不兼容MarkdownEditing的 scope 定义 - 中文标题显示异常（如乱码或字号过小）：检查字体设置是否含中文支持；
Preferences → Settings – Syntax Specific中可为Markdown GFM单独加{"font_face": "PingFang SC, sans-serif"}
真正卡住人的从来不是“装不上”，而是“以为装上就完了”。MarkdownEditing 的所有增强能力都依赖正确的语法作用域，而这个作用域不会自动降临——它得你亲手指定、反复验证、排除干扰。一个没关掉的原生 Markdown 语法包，就能让整套配置形同虚设。
