# markdown-syntax-formatter

Cleans up Markdown formatting, fixes broken heading hierarchies, and formats lists and code blocks under CommonMark and GFM specs.

- subagent · `type=agent` · Claude Code · 1065 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/ocr-extraction-team/markdown-syntax-formatter.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/agents/markdown-syntax-formatter

## What it does

This subagent inspects raw documents and applies CommonMark and GitHub Flavored Markdown rules to unformatted text. It converts visual emphasis, uppercase headings, and disparate bullet characters into standardized markdown elements. When it detects code segments, it wraps them into fenced code blocks and attaches language tags.

The subagent operates through `Read`, `Write`, and `Edit` tools to modify project files directly. It normalizes heading progression so that levels do not skip from H1 to H3, while indenting nested list items with two spaces. All original prose remains untouched during the pass, because the agent only adjusts markup and whitespace.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --agent ocr-extraction-team/markdown-syntax-formatter
```

2. **Manually: put the files in place**
- File: `.claude/agents/markdown-syntax-formatter.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/markdown-syntax-formatter.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/markdown-syntax-formatter.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/ocr-extraction-team/markdown-syntax-formatter.md

## When to use it
- Convert plain visual text or raw exports into standard Markdown
- Fix broken heading hierarchy to eliminate level skipping
- Standardize inconsistent bullet lists and nested indentation
- Enclose code snippets into fenced blocks with language identifiers

## Example prompts
- Format `notes.txt` into standard Markdown according to CommonMark
- Fix heading levels and nested lists in `docs/readme.md`
- Clean up syntax and wrap code segments in `draft.md`

## Similar
- [prompt-engineer](https://affpapa.org/en/nevibecode/agents/voltagent-community-prompt-engineer.md) — subagent · 16078 installs
- [context-manager](https://affpapa.org/en/nevibecode/agents/context-manager.md) — subagent · 10638 installs
- [code-explorer](https://affpapa.org/en/nevibecode/agents/code-explorer.md) — subagent · 1172 installs
- [search-specialist](https://affpapa.org/en/nevibecode/agents/search-specialist.md) — subagent · 6886 installs
- [api-documenter](https://affpapa.org/en/nevibecode/agents/api-documenter.md) — subagent · 6451 installs
- [technical-writer](https://affpapa.org/en/nevibecode/agents/technical-writer.md) — subagent · 4345 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 495 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md