lza6 Markdown 检查器
功能说明
一个 CLI 工具，用于检查 Markdown 文件的常见格式问题、样式一致性和断链。帮助在发布前捕获错误，维护文档质量。
主要功能：
- 标题层级验证 — 确保正确的嵌套关系（不跳过层级）
- 图片替代文本检查 — 标记没有描述性 alt 文本的图片
- 内部链接验证 — 检查内部链接（同一文档内）是否指向现有的锚点
- 行长度检查 — 警告超过可配置长度的行（默认 80 个字符）
- 尾随空白检测 — 查找并报告尾随空格/制表符
- 列表一致性 — 确保同一文档内列表标记（-、*、+）保持一致
- 代码块语言标注 — 建议为代码块添加语言规范
- 空链接检测 — 标记文本或 URL 为空的链接
- 重复标题 — 警告同一文件内重复的标题文本
- 外部链接检查 — 可选地验证外部 URL（需要联网）
使用方法
运行此技能：
./scripts/main.py run --input path/to/file.md
或检查多个文件：
./scripts/main.py run --input "*.md"
选项
--input：Markdown 文件路径（支持 glob 模式）--max-line-length：最大允许行长度（默认：80）--check-external-links：启用外部 URL 验证（默认：false）--ignore-rules：要忽略的规则 ID 列表（逗号分隔）
输出
返回包含检查结果的 JSON：
{
"file": "example.md",
"issues": [
{
"line": 10,
"column": 1,
"rule": "MD001",
"severity": "warning",
"message": "标题级别每次只能递增一级",
"fix": "将 ## 改为 #"
}
],
"summary": {
"total_issues": 5,
"errors": 2,
"warnings": 3
}
}
局限性
- 外部链接检查需要网络连接，可能较慢
- 可读性评分功能尚未实现
- 某些 Markdown 扩展（表格、脚注）可能无法完全验证
- 大文件（>10k 行）处理时间可能较长
- 内部链接的锚点检测仅适用于简单的锚点模式
示例
基本检查：
./scripts/main.py run --input README.md
自定义行长度：
./scripts/main.py run --input docs/*.md --max-line-length 100
启用外部链接验证：
./scripts/main.py run --input "**/*.md" --check-external-links
规则参考
- MD001：标题层级违规
- MD002：缺少图片替代文本
- MD003：内部链接失效
- MD004：行过长
- MD005：尾随空白
- MD006：列表标记不一致
- MD007：代码块缺少语言标注
- MD008：空链接
- MD009：重复标题
- MD010：外部链接失效（启用时）