md-tables

cosmix's avatarfrom cosmix

Fix markdown table alignment and spacing issues. Use when formatting tables in markdown files, aligning columns, normalizing cell padding, or ensuring proper table structure. Triggers: markdown table, table alignment, table formatting, md table, align columns.

⭐2stars🔀0forks📁View on GitHub🕐Updated Dec 31, 2025⬇️1downloads

When & Why to Use This Skill

This Claude skill is a specialized utility designed to automatically fix and format Markdown tables. It ensures consistent column alignment, normalizes cell padding, and preserves alignment markers (left, right, center) to improve the readability and professional appearance of technical documentation and README files.

Use Cases

  • Cleaning up messy, hand-written tables in README.md or technical manuals to ensure professional and consistent formatting.
  • Standardizing column widths and cell padding across multiple Markdown files to adhere to project style guides.
  • Fixing alignment issues in complex data tables, such as status reports or configuration settings, to ensure they render correctly in GitHub or other Markdown viewers.
  • Normalizing table structures after bulk data imports or automated content generation to maintain document integrity.
namemd-tables
descriptionFix markdown table alignment and spacing issues. Use when formatting tables in markdown files, aligning columns, normalizing cell padding, or ensuring proper table structure. Triggers: markdown table, md table, table formatting, column alignment, pipe table, GFM table, table generator, align columns, table spacing, table layout, fix table, format table, table structure.

Markdown Table Formatting

Utility for fixing markdown table alignment and spacing. Normalizes column widths, ensures consistent padding, and preserves alignment markers.

Quick Examples

# Preview fixed output
python fix-md-tables.py document.md

# Fix in-place
python fix-md-tables.py document.md -i

Common Patterns

Status tables:

| Stage    | Status    | Branch       |
| -------- | --------- | ------------ |
| build    | Complete  | loom/build   |
| test     | Executing | loom/test    |

Configuration tables:

| Option      | Default | Description           |
| ----------- | ------- | --------------------- |
| timeout     | 300     | Session timeout (sec) |
| auto_merge  | false   | Enable auto merging   |

Right-aligned numbers:

| Item  | Count | Total |
| ----- | ----: | ----: |
| Files |    42 |   500 |
| Lines | 1,234 | 5,000 |

Features

  • Aligns columns to consistent widths
  • Single-space padding for cells
  • Preserves alignment markers (:---, :---:, ---:)
  • Adds blank lines around tables

Alignment Markers

Syntax Alignment
--- Left (default)
:--- Left
---: Right
:---: Center