markdown-linter

Markdown Linter 是一款专注于 Markdown 文件质量检查与格式修复的文档型工具技能。该技能核心功能围绕两大模式展开：首选方案是利用成熟的 markdownlint-cli 工具进行自动化检查与修复，支持单文件或批量目录扫描；备选方案则通过内置的文本分析逻辑，手动检测标题层级跳跃、列表符号不一致、尾部空格、缺失空行、超长行、损坏的相对链接等常见问题，并提供具体的修复建议。

该技能的显著优点在于其纯文档型资产属性，意味着不存在任何代码执行风险，所有功能逻辑透明可查。它无需 API 密钥即可工作，支持自动生成目录（TOC），并提供了详尽的边界情况处理指南（如 MDX 文件、自动生成文档的特殊处理）。此外，技能推荐的配置方案（.markdownlint.json）允许用户根据项目需求灵活调整规则，例如设置行长度限制或允许 HTML 标签。

然而，该技能也存在一定局限性。首先，其来源为 T3 级个人账号，虽经安全审计内容无害，但长期维护与更新稳定性不如 T1/T2 级官方来源。其次，对于包含 JSX 语法的 MDX 文件，标准 Markdown 检查规则可能产生误报，需要手动关闭特定规则（如 MD033）。此外，链接验证功能主要依赖文本模式匹配，对于复杂的动态链接或外部 URL 的有效性检查能力有限。

该技能特别适合软件开发团队、技术文档撰写者、开源项目维护者以及任何需要维护大量 Markdown 文档的场景。它能够有效统一文档风格，预防死链，提升 README、开发文档、API 文档的专业度与可读性。

使用时的常规风险主要包括：处理超大文件时的性能消耗、可选依赖 markdownlint-cli 的版本兼容性问题（建议锁定版本号），以及相对链接验证可能因路径解析差异导致的假阳性或假阴性结果。建议在使用前审查推荐配置，并在持续集成（CI）流程中结合其他工具进行交叉验证。