How do I install the Autofix Markdown Tables skill?

Run npx skillmds@latest add specsnl/autofix-markdown-tables in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Autofix Markdown Tables safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Autofix Markdown Tables?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Autofix Markdown Tables free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Autofix Markdown Tables?

specsnl (@specsnl) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Autofix Markdown Tables by specsnl — Agent Skill

Name: Autofix Markdown Tables
Rating: 4.2 (5 reviews)
Author: specsnl

Autofix Markdown Tables

Use this skill to automatically fix misaligned markdown tables in .md files. Triggers after editing any markdown file that contains a table, before finishing documentation work, or when the user says "fix the tables", "align the markdown tables", or "format the markdown". Runs markdown-table-formatter via the project's `md:fix-tables` task, or via Docker when the project has no Taskfile, so columns are properly padded and aligned. After running, always review the diff to confirm only formatting changed — no content should be altered.

specsnl Updated Sep 22, 2026

File contents

Auto-fix Markdown Tables

Automatically detect and fix misaligned markdown tables across all .md files in the project.

Step 1: Run the formatter

Preferred — the project's own task

Specs projects ship a task for this. Check first:

task --list | grep -E 'md:(fix-tables|fixstyle)'

task md:fix-tables    # tables only
task md:fixstyle      # tables + markdownlint --fix

Use md:fixstyle when the project also lints markdown in CI (a Markdown workflow running markdownlint-cli2) — aligning tables alone can still leave the linter red.

Fallback — no Taskfile in this project

docker run --rm --volume $(pwd):/app --workdir /app node:24.15.0-bookworm bash -c "shopt -s globstar && npx --yes markdown-table-formatter **/*.md"

This command:

Mounts the current directory into a Node.js 24 container
Uses shopt -s globstar to enable recursive ** glob expansion in bash
Runs markdown-table-formatter on every .md file found recursively
Modifies files in-place — no output is written elsewhere

Step 2: Review the changes

After the formatter runs, check what was changed:

git diff --stat

For a detailed view of the actual table changes:

git diff

Verify that only whitespace/padding inside table cells changed — no content, wording, or structure should be altered. If unexpected changes appear, investigate before proceeding.

Step 3: Confirm

If the diff looks correct, the tables are properly aligned and the files are ready to commit. No further action is needed.

---name: autofix-markdown-tablesdescription: Use this skill to automatically fix misaligned markdown tables in .md files. Triggers after editing any markdown file that contains a table, before finishing documentation work, or when the user says "fix the tables", "align the markdown tables", or "format the markdown". Runs markdown-table-formatter via the project's `md:fix-tables` task, or via Docker when the project has no Taskfile, so columns are properly padded and aligned. After running, always review the diff to confirm only formatting changed — no content should be altered.---# Auto-fix Markdown TablesAutomatically detect and fix misaligned markdown tables across all `.md` files in the project.---## Step 1: Run the formatter### Preferred — the project's own taskSpecs projects ship a task for this. Check first:```bashtask --list | grep -E 'md:(fix-tables|fixstyle)'``````bashtask md:fix-tables # tables onlytask md:fixstyle # tables + markdownlint --fix```Use `md:fixstyle` when the project also lints markdown in CI (a `Markdown` workflow running`markdownlint-cli2`) — aligning tables alone can still leave the linter red.### Fallback — no Taskfile in this project```bashdocker run --rm --volume $(pwd):/app --workdir /app node:24.15.0-bookworm bash -c "shopt -s globstar && npx --yes markdown-table-formatter **/*.md"```This command:- Mounts the current directory into a Node.js 24 container- Uses `shopt -s globstar` to enable recursive `**` glob expansion in bash- Runs `markdown-table-formatter` on every `.md` file found recursively- Modifies files in-place — no output is written elsewhere## Step 2: Review the changesAfter the formatter runs, check what was changed:```bashgit diff --stat```For a detailed view of the actual table changes:```bashgit diff```Verify that only whitespace/padding inside table cells changed — no content, wording, or structure should be altered. If unexpected changes appear, investigate before proceeding.## Step 3: ConfirmIf the diff looks correct, the tables are properly aligned and the files are ready to commit. No further action is needed.

Frequently asked questions