# Markdown Formatter

> Format and clean up markdown documents following best practices

- Skill: `majiayu000/markdown-formatter` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/markdown-formatter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/markdown-formatter/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/markdown-formatter

---


# 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.