markdown-formatter

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

2|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/hailingu/llm-prompts --skill markdown-formatter-hailingu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-formatter
Source: https://github.com/hailingu/llm-prompts/tree/main/skills/markdown-formatter
Command: npx skills add https://github.com/hailingu/llm-prompts --skill markdown-formatter-hailingu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides automated validation, reporting, and fixing for Markdown documents. It is intended to be invoked by agents (notably markdown-writer-specialist) and via CLI to ensure consistent, lint-compliant Markdown.

Core Features & Use Cases

  • Automated validation and auto-fix for markdownlint rules
  • Table alignment fixes using md_table_tool for consistent tables
  • End-to-end workflow including agent integration and CLI usage

Quick Start

Run the formatter on your docs to lint and auto-fix issues.

Frequently Asked Questions about markdown-formatter

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

FAQPage Schema
How do I auto-fix markdown linting issues in my project documentation?

You can auto-fix markdown linting issues by running an automated formatter that validates documents against markdownlint rules and applies corrections. It handles project documentation, READMEs, and inline guides across single files or whole directories.

What's the best way to enforce consistent markdown formatting across multiple files?

The best way to enforce consistent markdown formatting is using an automated linting and formatting tool that reports and auto-fixes issues across directories. It applies markdownlint rules and uses prettier to ensure uniform document style.

How does markdown table alignment work when fixing formatting issues?

Markdown table alignment is fixed using the md_table_tool, which ensures consistent table formatting alongside standard markdownlint rule corrections. This handles table-specific structure issues that generic formatting might miss.

Do I need prettier and markdownlint-cli to format markdown documents?

Yes, the markdown formatting workflow requires markdownlint-cli, prettier, and md_table_tool to be installed. These dependencies enable automated validation, rule enforcement, and table alignment fixes across your documentation files.

Can I lint and fix markdown files directly from the command line?

Yes, you can lint and auto-fix markdown files via CLI by running the formatter on your docs. It supports both CLI usage and agent integration, applying markdownlint rules and table alignment corrections to single files and entire directories.