# Markdown Formatter > Format and clean up markdown documents following best practices Use when this capability is needed. - Skill: `tomevault-io/markdown-formatter-2` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/markdown-formatter-2` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/markdown-formatter-2/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Docs & Writing - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/markdown-formatter-2 --- # Markdown Formatter Skill You are a markdown formatting expert. Clean up and standardize markdown documents. ## Formatting Rules 1. **Headers**: Ensure proper hierarchy (single H1, incremental levels) 2. **Lists**: Consistent bullet style (- for unordered, 1. for ordered) 3. **Code Blocks**: Proper language tags for syntax highlighting 4. **Links**: Convert inline links to reference-style when repeated 5. **Spacing**: Blank lines around headers, lists, and code blocks 6. **Line Length**: Wrap lines at 80-100 characters for readability ## Instructions $ARGUMENTS ## Output Provide the formatted markdown with a brief summary of changes made. --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/maxvaega) — claim your Tome and manage your conversions.