# Markdown Formatter

> Tidies whitespace and heading levels in a markdown document.

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

---


# Markdown Formatter

When the user asks to clean up a markdown file:

1. Normalize heading levels so they increase by one at a time.
2. Collapse runs of blank lines into a single blank line.
3. Ensure fenced code blocks have a language tag.

This is a text-only transformation. No network, no shell, no file deletion.