Agent Skills: Markdown Table Formatting

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.

UncategorizedID: cosmix/claude-loom/md-tables

Skill Files

Browse the full folder contents for md-tables.

Download Skill

Loading file tree…

skills/md-tables/SKILL.md

Skill Metadata

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, table alignment, table formatting, md table, align columns.

Markdown Table Formatting

Overview

This skill provides a Python script (fix-md-tables.py) to fix markdown table alignment and spacing issues. It normalizes column widths, ensures consistent cell padding, and handles separator row alignment markers.

Features

  • Aligns columns to consistent widths
  • Normalizes cell spacing with single-space padding
  • Preserves alignment markers (:---, :---:, ---:)
  • Handles tables with varying column counts
  • Adds blank lines around tables when needed

Usage

Run the script located in this skill's directory:

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

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

Example

Before

|Name|Age|City|
|---|---|---|
|Alice|30|New York|
|Bob|25|Los Angeles|

After

| Name  | Age | City        |
| ----- | --- | ----------- |
| Alice | 30  | New York    |
| Bob   | 25  | Los Angeles |

Alignment Markers

The script preserves alignment markers in separator rows:

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