md-tables

Fix alignment and spacing issues in Markdown tables.

53|1|Updated Dec 18, 2025
One-click install
npx skills add https://github.com/cosmix/claude-code-setup --skill md-tables
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: md-tables
Source: https://github.com/cosmix/claude-code-setup/tree/main/skills/md-tables
Command: npx skills add https://github.com/cosmix/claude-code-setup --skill md-tables

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill fixes Markdown table alignment, spacing, and separator markers to produce clean, readable tables.

Core Features & Use Cases

  • Alignment Normalization: Aligns all columns consistently.
  • Separator Preservation: Keeps alignment markers intact.
  • Blank Line Handling: Adds appropriate spacing around tables.

Quick Start

Run the table-fixer on a document containing several misaligned Markdown tables.

Frequently Asked Questions about md-tables

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix misaligned Markdown tables?

Markdown table alignment involves normalizing column widths, preserving alignment markers (:---, :---:, ---:), and ensuring consistent cell padding. This Skill automatically adjusts spacing and separator rows to produce clean, readable tables in your Markdown documents.

Can I preserve alignment markers when formatting Markdown tables?

Yes. The Skill retains alignment markers intact while normalizing table structure. It maintains directional indicators (:---, :---:, ---:) and adjusts only spacing and column width, so your intentional alignment directives survive the formatting process.

What does Markdown table formatting do with blank lines around tables?

Markdown table formatting adds appropriate blank lines before and after tables to ensure proper document structure and readability. This prevents tables from merging with surrounding content and follows standard Markdown conventions.

How do I handle tables with varying column counts in Markdown?

This Skill applies alignment and spacing fixes to Markdown tables regardless of column count or structure. It normalizes all columns to uniform widths and handles separator rows consistently across tables of any size.

When should I use table formatting during documentation workflows?

Apply table formatting during documentation preparation, pre-commit checks, or linting phases. It ensures all Markdown tables meet consistent alignment and spacing standards before publishing or merging, reducing manual review overhead.

What's the difference between table alignment and table formatting?

Table alignment refers to directional markers and column positioning; table formatting encompasses alignment plus spacing normalization and blank line handling. This Skill performs both, producing fully formatted and visually consistent tables.