DSH VERIFY KIT · dsh-tablelint
Markdown 表格检查清单
它决定一件事:每张表的每行单元格数是否与表头一致。
检查规则
| 规则 | 判定 |
|---|---|
column-count | 某行单元格数与表头不符 → error,报行号 |
delimiter-count | 分隔行数量与表头不符 → error |
single-column | 只有一列的「表格」→ warn(那是列表) |
duplicate-header | 两列同名 → warn |
empty-header | 某列没有表头 → warn |
empty-table | 只有表头没有数据行 → warn |
用法
npx tablelint report.md --jsonnpx tablelint report.md --warnings-fail
真实输入输出
输入
| 项目 | 数量 |
| --- | --- |
| 一 | 2 |
| 三 | 4 | 6 |$ tablelint report-table.md
error column-count line 4: 3 cells in a 2-column table
fail: 1 errors, 0 warnings
出口码:1。输出为真实 CLI 运行的逐字结果,由测试与工具保持同步。
出口码:0 干净、1 有发现、2 用法或读文件错误。--json 输出机器可读结果,--warnings-fail 让警告也算失败。DSH 内同样的函数在 POST /tablelint/api({"text":"…"} 或 {"path":"…"}),面板与 CI 调同一实现,不可能不一致。
这是清单,不是专业人士。每条发现都是文件里可判定的结构缺陷,带行号或路径;它从不说「内容好不好」。
支持转义竖线(\|),代码块里的表格不参与检查—— fenced code 内的示例不该被当成缺陷。 · dsh-verify-kit 全部五个检查