必须使用准确命令名markdown_editing_markdown_lint并限定scope为text.html.markdown,在User.sublime-keymap中添加含context的JSON规则,否则快捷键静默失效;命令名和scope须通过命令面板及Show Scope Name实测确认。

MarkdownEditing 的 MarkdownEditing: Markdown Lint 命令怎么绑快捷键
直接绑定 MarkdownEditing: Markdown Lint 就能触发语法检查,但必须确认插件已安装且命令名完全匹配。这个命令名来自插件的 main.py 或命令面板真实输出,不是你“觉得”该叫什么——比如写成 markdown_lint 或 lint_markdown 都会静默失效。
操作步骤:
- 按
Ctrl+Shift+P(macOS 为Cmd+Shift+P),输入Markdown Lint,看到完整条目名就是你要用的command - 打开
Preferences → Key Bindings,在右侧User.sublime-keymap中添加规则 - 推荐加
context限定只在 Markdown 文件生效,避免误触:[{ "keys": ["ctrl+shift+m"], "command": "markdown_editing_markdown_lint", "context": [ {"key": "selector", "operator": "equal", "operand": "text.html.markdown"} ] }] -
text.html.markdown是 MarkdownEditing 插件实际使用的 scope,不是source.markdown——查法:在 Markdown 文件里按Ctrl+Shift+P → Show Scope Name,看状态栏显示的最靠前那个 scope
为什么绑了快捷键却没反应?三个高频卡点
不是插件坏了,也不是快捷键冲突,而是以下三处最容易出错:
-
User.sublime-keymap保存后右下角弹红字?90% 是 JSON 格式错误:末尾多逗号、引号不闭合、用了中文引号、括号没配对 - 命令名写错,比如抄网上旧教程写成
markdown_lint,而实际应为markdown_editing_markdown_lint(带下划线且含插件前缀) -
context的operand值不匹配当前文件 scope:比如你用的是原生 Markdown 语法(text.md),但写了text.html.markdown,那就永远不触发
想让语法检查只在保存时自动运行?别绑快捷键,改配置
快捷键是手动触发,自动检测得走插件设置。MarkdownEditing 支持保存时自动 lint,但需手动开启:
- 菜单 →
Preferences → Package Settings → MarkdownEditing → Settings – User - 添加字段:
"markdown_lint_on_save": true
- 注意:这和快捷键无关,也不需要重启;但若同时启用了外部
markdownlintCLI,还要确保路径正确,否则保存后控制台会报File not found
其他语法检测插件(如 SublimeLinter)的快捷键命名规律
不同插件的 command 名风格差异很大,不能套用:
-
SublimeLinter不提供全局 lint 命令,它靠实时高亮 + 右键菜单,真正可绑定的是sublimelinter_toggle_panel(开关面板)或sublimelinter_show_all_errors -
SublimeLinter-contrib-eslint类插件,command 名通常带eslint字样,但必须通过命令面板实测,比如eslint_fix或sublimelinter_eslint_fix - 所有带
contrib-前缀的 linter 插件,command 名几乎都不统一,查不到就打开控制台输sublime.log_commands(True),再右键选一次“Fix this error”,看输出什么
User.sublime-keymap 里的那条 JSON 规则,而 command 名和 context scope 这两个字符串,差一个字符就等于没配。


















