markdown-tables

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

51|3|Updated Dec 25, 2025
One-click install
npx skills add https://github.com/rust-works/succinctly --skill markdown-tables-rust-works
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-tables
Source: https://github.com/rust-works/succinctly/tree/main/.claude/skills/markdown-tables
Command: npx skills add https://github.com/rust-works/succinctly --skill markdown-tables-rust-works

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Markdown tables often render with uneven alignment in plain text editors and diffs; fixed-width padding makes tables readable across environments.

Core Features & Use Cases

  • Fixed-width columns with space padding for readability in plain text editors and diffs.
  • Column width calculation based on the widest cell per column, with consistent alignment for headers and data.
  • Supports complex tables (bold text, mixed content) while preserving alignment.
  • Use cases include preparing READMEs, documentation, and data-heavy tables where diff readability matters.

Quick Start

Format the markdown table in your document to fixed-width columns.

Frequently Asked Questions about markdown-tables

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

FAQPage Schema
How do I format markdown tables for fixed-width alignment in plain text editors?

Formatting markdown tables for fixed-width alignment involves calculating the widest cell per column and applying consistent space padding to headers and data rows. This ensures tables remain readable across plain text editors and diffs.

Why does markdown table alignment break in diffs and how do I fix it?

Markdown table alignment breaks in diffs when cells have uneven character widths without padding. Fixing alignment requires enforcing fixed-width padding across all columns, calculating width based on the widest cell, and applying consistent spacing to headers and data rows.

Can I preserve alignment in complex markdown tables with mixed content and bold text?

Yes, formatting markdown tables supports complex content including bold text and mixed data while preserving alignment. The column width calculation accounts for the widest cell in each column, ensuring consistent fixed-width formatting across all rows.

What is the best way to make README tables readable across different environments?

The best way to make README tables readable across environments is to format them with fixed-width columns using space padding. Calculating per-column width based on the widest cell ensures consistent alignment in plain text editors, wikis, and documentation.

When do I need to use fixed-width padding for markdown tables?

Fixed-width padding for markdown tables is needed when preparing documentation, READMEs, or wikis with data-heavy tables where diff readability matters. It ensures columns align properly in plain text editors and version control diffs.