Standardizes Markdown file creation and editing by applying consistent style conventions and linting rules.
The write-markdown skill ensures all project documentation follows professional standards, specifically targeting GitHub Flavored Markdown (GFM) and markdownlint-cli2 rules. It automates the formatting of complex elements like tables with vertically aligned pipes, ensures every code block has a mandatory language identifier, and maintains consistent document structure including heading hierarchies and spacing. This skill is essential for maintaining high-quality, lint-compliant documentation and preventing build failures in CI/CD pipelines.
Key Features
011 GitHub stars
02Vertically aligns Markdown table pipes and pads cells for professional readability
03Enforces mandatory language identifiers for all fenced code blocks to ensure syntax highlighting
04Integrates with local lint-fix scripts and markdownlint-cli2 for automated validation
05Validates heading structures to prevent skipped levels and duplicate titles
06Standardizes list markers and nested indentation across all document sections
Use Cases
01Auditing and refactoring legacy Markdown files to meet modern linting standards
02Creating and formatting professional README files or project documentation from scratch
03Cleaning up messy data tables and inconsistent list styles in existing documentation
