Markdown 表格整理

把松散、未对齐的 Markdown 表格整理成列宽对齐、可读性强的规整表格。

何时使用

• 用户粘贴了一段管道符没对齐的 Markdown 表格
• 手写表格后想一键美化
• 单元格数量对不齐、分隔行 --- 写法不统一

对齐规则

1. 每一列取该列所有单元格（含表头）的最大显示宽度，按此宽度左对齐补空格。
2. 中文/全角字符按 2 个显示宽度计算，避免看起来错位。
3. 分隔行统一为 | --- | --- | 形式；保留 : 对齐标记（:---、---:、:---:）。
4. 行内单元格数少于表头时右侧补空单元格，多余的截断并提示。

用法

对齐一个 Markdown 文件里的所有表格（原地整理，打印到 stdout）：

python scripts/align_table.py input.md

从标准输入读取（适合粘贴片段）：

pbpaste | python scripts/align_table.py -

示例

输入：

| 名称 | 说明 | 版本 |
|-|-|-|
| git-commit-helper | 提交规范助手 | 1.0.0 |
| markdown-table-formatter | 表格整理 | 1.0.0 |

输出：

| 名称                     | 说明         | 版本  |
| ------------------------ | ------------ | ----- |
| git-commit-helper        | 提交规范助手 | 1.0.0 |
| markdown-table-formatter | 表格整理     | 1.0.0 |