# markdown-content-creation

Задаёт стандарты вёрстки блоговых постов в Markdown: запрещает заголовки H1, требует строгий YAML front matter и форматирует списки с таблицами.

- правило · `type=rule` · GitHub Copilot · ★ 40418
- Автор: github · официальный репозиторий GitHub
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/github/awesome-copilot/tree/HEAD/instructions/markdown-content-creation.instructions.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/rules/markdown-content-creation

## Что делает

Правило применяется ко всем файлам `**/*.md`. Оно полностью запрещает заголовки H1, так как главный заголовок публикации формируется автоматически. Структура текста строится через `##` для H2 и `###` для H3. Если в тексте появляются H4 или H5, правило требует пересмотреть и упростить иерархию разделов. Вложенные списки требуют отступа ровно в два пробела, а блоки кода обязательно содержат метку языка.

Длина строк ограничена 400 знаками, при этом перенос рекомендуется делать на 80 символах. Блок YAML front matter должен содержать строгий набор полей: `post_title`, `author1`, `post_slug`, `microsoft_alias`, `featured_image`, `categories`, `tags`, `ai_note`, `summary` и `post_date`.

Без файла `/categories.txt` валидация категорий завершится с ошибкой, так как правило сверяет теги именно с этим списком.

## Установка

### GitHub Copilot (родная платформа)

**Вручную: положить файлы**
- Файл: `.github/instructions/markdown-content-creation.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/rules/markdown-content-creation.md` — Поле paths во frontmatter ограничивает файлы: applyTo из источника → paths

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/markdown-content-creation.mdc` — Во frontmatter: description, globs, alwaysApply. applyTo из источника → globs, иначе правило само не подключится

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/markdown-content-creation.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/markdown-content-creation.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/github/awesome-copilot/tree/HEAD/instructions/markdown-content-creation.instructions.md

## Когда брать
- заполнить метаданные YAML front matter по чек-листу
- исключить заголовки первого уровня в теле публикации
- настроить явное указание языка для блоков кода
- выровнять колонки таблиц и отступы во вложенных списках

## Примеры запросов агенту
- Оформи черновик статьи в Markdown по правилам репозитория и добавь front matter.
- Проверь структуру заголовков в `blog-post.md` и переделай уровни ниже H3.

Из того же набора: [github/awesome-copilot](https://affpapa.org/nevibecode/by/github/awesome-copilot.md) — 928 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md