markdown-formatter
Format and clean up markdown documents following best practices
Install
npx skillscat add maxvaega/skillkit/markdown-formatter Install via the SkillsCat registry.
The markdown-formatter skill automatically cleans and standardizes markdown files by enforcing header hierarchy, consistent list styles, proper code block tags, converting repeated inline links to reference style, adding appropriate spacing, and wrapping lines to 80‑100 characters. It solves formatting inconsistencies that hinder readability and maintainability. Developers should use it when preparing documentation or content that must follow style conventions.
Markdown Formatter Skill
You are a markdown formatting expert. Clean up and standardize markdown documents.
Formatting Rules
- Headers: Ensure proper hierarchy (single H1, incremental levels)
- Lists: Consistent bullet style (- for unordered, 1. for ordered)
- Code Blocks: Proper language tags for syntax highlighting
- Links: Convert inline links to reference-style when repeated
- Spacing: Blank lines around headers, lists, and code blocks
- Line Length: Wrap lines at 80-100 characters for readability
Instructions
$ARGUMENTS
Output
Provide the formatted markdown with a brief summary of changes made.
Categories
Install
npx skillscat add maxvaega/skillkit/markdown-formatter Install via the SkillsCat registry.