markdown-syntax-formatter — субагент для Claude Code
Форматирует разметку Markdown, выравнивает структуру заголовков и оформляет списки с блоками кода по спецификациям CommonMark и GFM.
npx claude-code-templates@latest --agent ocr-extraction-team/markdown-syntax-formatterЧто делает markdown-syntax-formatter
Субагент проверяет структуру документа и приводит неструктурированный текст к стандартам CommonMark и GitHub Flavored Markdown. Он переводит визуальные маркеры — заголовки капсом, разнородные буллеты вроде точек или звёздочек — в корректный синтаксис. Для блоков кода добавляет тройные обратные кавычки и язык, если он понятен из контекста.
В работе агент опирается на инструменты Read, Write и Edit. Он выстраивает иерархию заголовков без пропусков уровней, выставляет двухпробельные отступы для вложенных списков и расставляет пустые строки вокруг блоков. Исходный текст остаётся неизменным: меняется исключительно оформление разметки.
Какие задачи решает
- Преобразовать неформатированный текст или выгрузки в стандартный Markdown
- Исправить порядок заголовков без пропусков между уровнями H1, H2 и H3
- Унифицировать списки с разной символикой маркеров и кривыми отступами
- Оформить фрагменты кода в блоки с указанием языка подсветки
Примеры запросов агенту
- Отформатируй файл
notes.txtв чистый Markdown по правилам CommonMark - Исправь структуру заголовков и списки в
docs/readme.md - Преврати сырой конспект в
draft.mdв структурированный документ с блоками кода
Как установить markdown-syntax-formatter
1Через claude-code-templates
npx claude-code-templates@latest --agent ocr-extraction-team/markdown-syntax-formatter2Вручную: положить файлы
.claude/agents/markdown-syntax-formatter.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/markdown-syntax-formatter.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/markdown-syntax-formatter.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о markdown-syntax-formatter
Как установить markdown-syntax-formatter в Claude Code?
Выполните команду npx claude-code-templates@latest --agent ocr-extraction-team/markdown-syntax-formatter. Конфигурация субагента запишется по пути .claude/agents/markdown-syntax-formatter.md.
Что делает markdown-syntax-formatter?
Субагент наводит порядок в Markdown-документах: расставляет верные уровни заголовков, форматирует списки с двухпробельным отступом, добавляет пустые строки и заключает код в блоки с нужным языком.
Какие инструменты использует markdown-syntax-formatter?
Субагенту требуются встроенные инструменты Read, Write и Edit, чтобы читать файлы проекта и вносить правки прямо в документ.
