markdown-table-discipline

Enforce Markdown table structure with header rows, five-column limits, and cell brevity.

8|1|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/bordenet/superpowers-plus --skill markdown-table-discipline
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-table-discipline
Source: https://github.com/bordenet/superpowers-plus/tree/main/skills/writing/markdown-table-discipline
Command: npx skills add https://github.com/bordenet/superpowers-plus --skill markdown-table-discipline

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Enforces consistent, accessible, and concise Markdown table construction to prevent visual noise, redundant data, and rendering inconsistencies across documentation and wikis.

Core Features & Use Cases

  • Decision gate that recommends lists for tiny or hierarchical data and enforces tables only when comparison or structured scanning is required.
  • Structural validation: requires header rows, limits columns to five, forbids multi-line cells, and enforces primary-key blank runs and cell brevity.
  • Accessibility and formatting guidance: alignment conventions, vocabulary normalization, and HTML-aware rules for proper header semantics.

Quick Start

Convert a small two-row markdown table into a bullet list and apply the table discipline rules for headers, column limits, and cell brevity.

Frequently Asked Questions about markdown-table-discipline

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

FAQPage Schema
How do I make Markdown tables more accessible in documentation?

Markdown tables become accessible when you enforce header rows, limit columns to five, and prevent multi-line cells. Applying alignment conventions and cell brevity ensures proper header semantics and consistent rendering across documentation platforms.

When should I use a Markdown table versus a list for formatting data?

Choose Markdown tables when users need to compare or scan structured data across columns. For tiny or hierarchical data, use bullet lists instead to avoid visual noise and redundant formatting in documentation.

What are the best practices for formatting multi-column Markdown tables?

Formatting multi-column Markdown tables requires header rows, a maximum of five columns, and concise cells. Preventing multi-line content and applying alignment conventions maintains structural validation and consistent rendering in documentation.

Why does my Markdown table render inconsistently across different documentation platforms?

Inconsistent Markdown table rendering often stems from missing headers, excessive columns, or multi-line cells. Enforcing structural validation and HTML-aware header semantics ensures consistent display across documentation platforms and wikis.

How do I convert a small Markdown table into a bullet list?

Convert a small Markdown table into a bullet list by identifying tiny two-row data sets and replacing the table structure with hierarchical list formatting. This reduces visual noise and improves documentation readability.