# Markdown Formatter

> Format and tidy markdown documents for consistent style.

- Skill: `waelabouceo/markdown-formatter` (Agent Skill)
- Install (CLI): `npx skillmds@latest add waelabouceo/markdown-formatter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/waelabouceo/markdown-formatter/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

---


# Markdown Formatter

Use this skill to clean up markdown files.

## Steps

1. Read the target markdown file.
2. Normalize heading levels so they increase by at most one at a time.
3. Ensure there is exactly one blank line between sections.
4. Wrap long paragraphs at 100 characters.
5. Write the formatted content back to the file.

## Notes

This skill only reads and writes the files the user explicitly points it at.
It performs no network access and runs no shell commands.