skills.rest
walsh-investment
walsh-investmentOFFICIAL
Explore all skills by this author →
GitHub

markdown-tables

Align and format Markdown tables with consistent column padding and separator alignment.

Updated Sep 1, 2025
Search Tags:#markdown#readability#formatting#alignment#docs#tables#markdown-tables
One-click install
npx skills add https://github.com/walsh-investment/clean-slate-import --skill markdown-tables-walsh-investment
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: markdown-tables
Source: https://github.com/walsh-investment/clean-slate-import/tree/main/.claude/skills/markdown-tables
Command: npx skills add https://github.com/walsh-investment/clean-slate-import --skill markdown-tables-walsh-investment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Markdown tables often become unreadable in raw source when column widths do not align, making manual edits error-prone. This skill ensures tables are aligned and readable in the plain text representation.

Core Features & Use Cases

  • Aligns Markdown tables so every column is padded to the width of the longest cell (including the header) and the separator lines line up.
  • Applies to any .md file that contains or will contain tables, whether creating new tables or editing existing ones.
  • Supports wrapping and multi-line cells when necessary to keep the table within a reasonable width while preserving readability.

Quick Start

Format every Markdown table in your repository so the raw source shows aligned columns.

Frequently Asked Questions about markdown-tables

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

FAQPage Schema
How do I align Markdown tables so the raw source stays readable?▼

Yes, this formatting supports multi-line cells by wrapping content where necessary to keep the table within a reasonable width. It preserves readability while handling complex cell structures across any .md file.

Can I format existing tables in my Markdown docs without breaking them?▼

Markdown tables become unreadable in raw source when column widths do not align, making manual edits error-prone. Consistent separator alignment and deterministic padding solve this by keeping the plain text representation visibly structured.

What's the best way to ensure consistent separator alignment in Markdown tables?▼

Formatting applies to any Markdown file that will contain tables, whether you are creating new ones or editing existing ones. It ensures deterministic padding and consistent alignment across all tables in the document.

Do I need any dependencies to format Markdown tables in my repository?▼

When creating new Markdown tables, the formatting ensures every column is padded to the longest cell width and separator lines line up. This keeps the raw source readable from the moment the table is created.

Related Skills

Explore More Content & Communication Skills→
rust-worksrust-works
51

markdown-tables

Format Markdown tables with fixed-width columns and aligned headers.

Official
Intermediate
Jiale-ZouJiale-Zou

chart-extract

Extract tabular data from experimental results into JSON and Markdown tables.

Community
Intermediate
rysweetrysweet
2

mermaid-diagram-generator

Convert architecture and workflow descriptions into valid Mermaid diagrams.

Community
Intermediate
hailinguhailingu
2

markdown-formatter

Lints and auto-fixes Markdown formatting issues in files and directories using markdownlint-cli, Prettier, and md_table_tool for tables.

Community
Advanced