用途:这是供 markdown-a11y-assistant、markdown-scanner、markdown-fixer 等智能体及 markdown-accessibility 常驻指令复用的知识模块,本身是参考数据而非审查器,用于对 Markdown 文档做无障碍审计与修复。
主要能力:覆盖 9 个领域,包括描述性链接(WCAG 2.4.4,处理含糊链接文字、裸 URL、重复相同文字)、图片替代文本(1.1.1)、标题层级(1.3.1/2.4.6)、表格无障碍(1.3.1)、emoji(1.3.3/认知)、Mermaid 与 ASCII 图(1.1.1/1.3.1)、破折号规范化、锚点链接校验(2.4.4)、平实语言与列表结构。提供严重度评分:文件得分 = 100 - 加权问题之和,Critical 每项 -15、Serious -7、Moderate -3、Minor -1,下限 0,并按 90-100 A、75-89 B、50-74 C、25-49 D、0-24 F 分级。
使用方式:emoji 处理有 remove-all、remove-decorative、translate、leave-unchanged 四种模式,按“任务显式覆盖 → 作用域内最近的 *.instructions.md → 技能默认 remove-decorative”的顺序解析;translate 模式按内置翻译表替换,表外 emoji 标记为需人工复核。Mermaid 与 ASCII 图会生成文字描述并把原始源码放入 details 折叠块。可用命令:npx --yes markdownlint-cli2 <filepath>。
适用场景与限制:适合审计和修复 Markdown 文档的无障碍问题。部分问题无法自动修复,如缺失 alt 文本、复杂图表描述、断链锚点需人工判断;复杂 Mermaid 类型(sequenceDiagram、classDiagram、erDiagram、stateDiagram)标记为需人工复核。含 emoji 的标题生成的锚点不稳定,应标记。具体安装与集成步骤资料未提供。