fix-markdown-lint

What problem does it solve?

Inconsistent Markdown formatting leads to messy documentation and CI/CD failures. This Skill automates the process of identifying and fixing Markdown linting errors using markdownlint-cli2, ensuring your documentation adheres to project standards and passes all automated checks, saving you manual correction time.

Core Features & Use Cases

• Error Detection: Runs markdownlint-cli2 to identify all formatting issues in Markdown files.
• Automatic Fixes: Automatically corrects ~95% of common linting errors (e.g., trailing spaces, blank lines around lists).
• Manual Guidance: Provides clear instructions for manually fixing remaining errors like ordered list numbering.
• Use Case: Your CI pipeline failed due to Markdown linting errors. Use this Skill to automatically fix most issues, get clear guidance on the few remaining manual fixes, and quickly get your documentation back to a passing state.

Quick Start

Fix all markdown linting errors in the documentation files.