Markdown 语法检查

怎么用

1. 把 Markdown 粘贴进编辑器，边打字边出结果。
2. 按检查强制重跑一遍，或用显示筛选只留错误、警告或提示。
3. 看报告：每行给出行号、级别、规则名和问题说明。
4. 点任意一行，编辑器会选中对应行，方便就地修改。
5. 载入 Sample 看一份带多个问题的文档长什么样。

常见用法

• 提 PR 前自检文档 —— 抓住跳过层级的标题、别人留下的空链接。
• 清理导入的内容 —— 转换出来的导出件常带着行尾空格和堆叠的空行。
• 应对无障碍评审 —— 图片缺 alt 会被当作错误报出来，不用等评审去发现。
• 落实风格规范 —— 标题重复通常意味着两个小节被误合并了。
• 教 Markdown —— 规则名直接告诉新手该避开哪种写法。

常见问题

问：它检查哪些规则？ 答：标题层级跳跃、标题文字重复、围栏代码块缺语言、空链接与未闭合链接、空链接文字、图片无 alt、行尾空白、连续空行、列表缩进不一致。

问：为什么我的文档只有警告没有错误？ 答：错误用于破坏标记意图的问题，比如指向空处的链接；警告用于值得复核但渲染仍正常的写法，比如缺语言的代码块。

问：它按 CommonMark 还是 GFM？ 答：它识别这些规则涉及的 CommonMark 结构，包括 ATX 标题与反引号或波浪号围栏代码块。它不是完整解析器，报告的是模式而不是语法树。

问：为什么问题会指向代码块内的某一行？ 答：不会。围栏代码块内的内容一律跳过，只有围栏本身会在开头缺语言时被报出来。

问：它会帮我改 Markdown 吗？ 答：不会，只报行号和规则名。改不改由你决定 —— 因为有些命中其实是有意为之。