SuperAPI AI 工具集

markdown-table-validator

通用与其它

查看项目

更新于 10-16 05:42

技能介绍

用途:扫描 Markdown 文件,找出会让 GFM 表格在 GitHub / VS Code 预览中退化为普通段落的结构性问题,并可选自动转义最常见的原因——单元格内未转义的竖线。

主要能力:检测 column-overflow(某行列数多于表头,通常因单元格内未转义 |)、header-mismatch(表头与分隔行列数不一致)、indented-table(表格缩进 ≥4 空格被当作代码块)、alignment-colon-in-row(对齐标记出现在数据行);还提示 short-row 与 missing-blank-line。围栏代码块内的示例表格会被跳过。

使用方式:可用以下命令扫描单个文件或整个目录树,报告问题并在存在渲染错误时退出码为 1: SCAN="$(cc-plugin-root doc-tools)/skills/markdown-table-validator/scripts/scan_markdown_tables.ts" bun "$SCAN" path/to/FILE.md bun "$SCAN" "docs//*.md" "plugins//*.md" 可选自动修复: bun "$SCAN" --fix path/to/FILE.md prettier --write path/to/FILE.md 输出为编译器风格 path:line: severity: message [code]。

适用场景:批量清理既有文档中的坏表格;与逐次编辑的 PostToolUse 守卫配合,后者防止新增破坏,本技能用于全仓库清理。

限制:--fix 仅按“真实列取前 N 列、其余竖线转义为 |”的启发式猜测,可能误判,需人工审查 diff 后再运行 prettier 重新对齐;GFM 表格分词器即使在 code span 内也把 | 视为列分隔符,转义会改变含义,故需人工确认。部分细节(如具体安装方式、收费与平台支持)资料暂未提供。