What problem does it solve? Markdown files often contain subtle syntax errors, inconsistent formatting, and lint violations that break rendering or fail CI checks. This Skill provides a complete reference for authoring clean, lint-compliant Markdown so documents render correctly and pass markdownlint validation. ## Core Features & Use Cases - Lint Rule Reference: Covers the full markdownlint rule set (MD001–MD060) with aliases, tags, and inline configuration comments for surgical rule control. - Syntax Guidance: Documents CommonMark and GitHub Flavored Markdown syntax including tables, task lists, alerts, footnotes, and Mermaid diagrams. - Deprecated Pattern Detection: Lists incorrect patterns (setext headings, indented code blocks, bare URLs) alongside their correct replacements. - Use Case: When drafting a README that fails markdownlint in CI, use this Skill to identify violations like missing blank lines around lists (MD032) or code blocks without language identifiers (MD040) and fix them correctly. ## Quick Start Review my README.md file and fix all markdownlint violations while following GitHub Flavored Markdown best practices.