markdown-formatter

Markdown formatting enforces consistent style across headers, lists, code blocks, links, and images. This Skill applies ATX header usage, fenced code blocks with language identifiers, consistent list markers, descriptive link text, spacing rules, and validation workflows to polish technical documentation, READMEs, and knowledge bases into readable, standardized docs.

Follow ATX header syntax for headers and use fenced code blocks with language identifiers for code samples. This Skill guides you through header hierarchy rules, then proceeds to lists, code emphasis, links, images, and spacing to create a complete formatting workflow that meets documentation standards.

Yes. This Skill includes validation checks and automated improvements that assess headers, lists, code blocks, links, images, and spacing against style requirements. Ready-to-run templates support both validation and formatting workflows for consistent technical documentation.

Use descriptive link text and descriptive alt text for images. This Skill enforces these requirements as part of its formatting phase, ensuring links and images communicate their purpose clearly and improve accessibility across READMEs, API references, and knowledge bases.

Start immediately with phase-based formatting. Load the headers-hierarchy module first, then proceed through lists, code, links, images, and spacing templates in sequence. No prerequisite restructuring is needed; the Skill guides you through a complete polish workflow.

Linting identifies style violations; formatting applies corrections and enforces consistency. This Skill combines both—it validates markdown against style rules and automatically improves structure, spacing, and element consistency across technical documentation.