md-tables
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.
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.
| name | md-tables |
|---|---|
| description | 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, 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 |