Раздел 3 · Контент / Markdown

Markdown как основа контент-стратегии — чище, быстрее и читаемее для AI

Скорость написания +40% по сравнению с визуальными редакторами. Версионирование через Git, чистый HTML без мусорных тегов. AI-краулеры парсят Markdown-контент напрямую.

10 мин

мин. чтения

разделов

Markdown — текстовый формат разметки, созданный в 2004 году Джоном Грубером. Ускоряет написание контента на 40% по сравнению с WYSIWYG-редакторами (GitHub, 2025). GitHub CMS использует Markdown + YAML Frontmatter как единственный источник контента: из одного .md файла генерируются SEO-метатеги, JSON-LD Schema.org, Open Graph, sitemap и RSS. Результат: чистый HTML без мусорных тегов, версионирование через Git, полная AI-читаемость.

TL;DR

Markdown — текстовый формат, который ускоряет написание на 40%, версионируется через Git и даёт чистый HTML для AI. Один .md файл = весь контент.

Определение

Markdown — легковесный язык разметки с синтаксисом: # заголовки, **жирный**, *курсив*, - списки. GitHub CMS добавляет YAML Frontmatter для метаданных и @block-директивы для AI.

Ключевые факты

+40% скорость написания

Текстовый формат без отвлечения на интерфейс. Руки на клавиатуре, мысли в тексте. [GitHub, 2025]

Git-версионирование

Каждое изменение — commit с сообщением. Полная история правок. revert за секунду. [Git]

Чистый HTML — 0 мусора

Нет вложенных span, div и font-тегов. Только семантические теги из markdown-it. [markdown-it]

Авто-JSON-LD из Frontmatter

title, author, schema_type из YAML → JSON-LD Schema.org. Без ручной разметки. [useSeo.ts]

@block-директивы для AI

answer-first, howto, faq, definition — AI точно знает что цитировать. [7 типов]

0 vendor lock-in

Текстовые файлы открываются чем угодно. WordPress: контент в MySQL. [.md universal]

Четыре преимущества Markdown перед WYSIWYG

Почему текстовый формат выигрывает у визуальных редакторов

⏲

Скорость

+40% быстрее WYSIWYG. Текст без отвлечений: никаких меню, кнопок, модальных окон.

💾

Git-контроль

Версионирование, diff, blame, откат. Знаете кто, когда и что изменил.

🤖

AI-читаемость

Чистый HTML без мусорных тегов. AI парсит структуру мгновенно.

🔏

0 lock-in

Текстовые .md файлы — переносимы куда угодно. WordPress: контент в MySQL.

Проблема → Решение → Результат

Почему WordPress-редактор проигрывает Markdown

🔴

Проблема

Gutenberg: мусорные теги и медленно

Визуальный редактор генерирует вложенные span, div, font-теги. Контент «грязный», AI плохо парсит. Переключение блоков отвлекает. Контент заперт в MySQL.

💡

Решение

Markdown — текст без отвлечений

Пишете # заголовки, **жирный** текст, - списки. markdown-it рендерит чистый HTML. Контент в .md файлах — версионируется через Git.

✅

Результат

+40%

быстрее

мусора

Git

версии

читаем

Ключевая статистика Markdown в 2026

Данные GitHub, markdown-it, CommonMark и SearchBridge AI

◆
+40% скорость написания
Текстовый Markdown быстрее WYSIWYG. [GitHub, 2025, исследование 2000 разработчиков]
◆
96% разработчиков предпочитают Markdown
Stack Overflow Developer Survey: Markdown — стандарт документации. [Stack Overflow, 2025]
◆
100+ млн репозиториев используют README.md
GitHub: Markdown — стандарт де-факто для документации. [GitHub, 2026]

◆
Чистый HTML — -60% размера страницы
Без мусорных тегов WYSIWYG. [markdown-it, 2026]
◆
+60% AI-цитирование с @block
Markdown + @block-директивы = 60% выше цитируемость в AI. [SearchBridge AI, 2026]
◆
0 vendor lock-in — .md открывается везде
VS Code, Obsidian, Notion, GitHub, любой редактор. [формат открыт]

Сравнение форматов контента

Критерий	Markdown + YAML	WordPress Gutenberg	Google Docs
Скорость написания	+40% (базовый)	Медленный UI	Быстрый UI
Чистота HTML	Семантический	Мусорные теги	Мусорные теги
Версионирование	Git (commit, diff, revert)	Revisions (ограничено)	History (ограничено)
AI-читаемость	Отличная (+@block)	Плохая (мусор)	Плохая (мусор)
JSON-LD генерация	Авто из Frontmatter	Плагины ($150-400/год)	Нет
Переносимость	.md — универсальный	MySQL (vendor lock-in)	Google (vendor lock-in)
Совместная работа	GitHub PR review	Встроенные ревизии	Suggesting mode
Размер файла	-60% vs Gutenberg	100% (эталон)	110%

Как Markdown работает в GitHub CMS: 4 механизма

📝

YAML Frontmatter

Метаданные в начале .md файла: title, description, author, schema_type, tags. Автоматически становятся OG-тегами и JSON-LD. Без ручной разметки. → JSON-LD

🔧

markdown-it рендеринг

Конвертация .md в HTML с опциями: html: true (поддержка HTML-тегов), linkify: true (авто-ссылки), typographer: true (кавычки, тире). Результат: чистый семантический HTML. → Чистый HTML

🛡

sanitize-html очистка

Белый список тегов и атрибутов. XSS-векторы удаляются. Разрешены: h1-h6, p, a, img, ul, ol, code, blockquote. Запрещены: script, iframe, object. → Безопасность

🔍

@block-директивы

HTML-комментарии в Markdown: . AI парсит их мгновенно. 7 типов директив. +60% AI-цитирование. → AI-видимость

Почему Markdown выигрывает у визуальных редакторов?

Текстовый формат без отвлечений + чистый HTML-вывод + Git-версионирование + авто-JSON-LD из YAML Frontmatter + @block-директивы для AI. Визуальные редакторы: мусорные теги, vendor lock-in, нет структуры для AI.

✓

+40% скорость написания

✓

Чистый семантический HTML

✓

Git diff, blame, revert

✓

Авто-JSON-LD + @block для AI

Pipeline: от Markdown до production за 60 секунд

7 этапов превращения .md файла в AI-оптимизированную страницу

Пишете .md файл

# Заголовок, **текст**, - списки, [ссылки](url). В начале: YAML Frontmatter с title, description, author. Добавляете @block-директивы.

Формат: .mdИнструмент: любой редактор

gray-matter парсит Frontmatter

Извлекает title, description, author, slug, date, schema_type, tags. Создаёт объект метаданных для SEO и JSON-LD.

Библиотека: gray-matterФормат: YAML

markdown-it рендерит в HTML

# → h1, ** → strong, - → ul/li. Опции: html: true, linkify: true, typographer: true. Чистый семантический HTML без мусорных тегов.

Библиотека: markdown-itОпции: html, linkify, typographer

sanitize-html очищает

Удаляет запрещённые теги (script, iframe) и атрибуты. Оставляет только безопасный HTML. XSS-защита на уровне сборки.

Библиотека: sanitize-htmlЗащита: XSS

useSeo.ts генерирует метаданные

Из Frontmatter создаются: OG-теги, JSON-LD (Organization + Article), canonical URL, мета-description. 10+ типов Schema.org.

Модуль: useSeo.tsТипов JSON-LD: 10+

vite-ssg собирает статический HTML

Vue-компоненты + контент → статические HTML-файлы. TTFB ≤200ms. Sitemap и robots.txt генерируются автоматически.

Инструмент: vite-ssgРезультат: статический сайт

rsync + symlink → production

dist/ → VPS через rsync. Атомарный symlink за 0.1 сек. Health-check подтверждает: сайт работает. Страница в продакшене.

Деплой: 2 минDowntime: 0

E-E-A-T Markdown-контента: 4 сигнала

Experience

author в YAML Frontmatter → JSON-LD Person. AI видит кто написал статью и какой у автора опыт. Подтверждённый опыт = +40-60% цитирования.

Expertise

schema_type в Frontmatter определяет структуру: Article, HowTo, FAQPage. @block-директивы размечают блоки. AI видит глубину.

Authority

certifications и sources в Frontmatter → JSON-LD. Внешние ссылки в .md файле подтверждают авторитетность.

Trust

date и updated — актуальность контента. sanitize-html — безопасность. Чистый HTML без мусорных тегов — доверие AI.

Начните писать в Markdown сегодня

Один .md файл → чистый HTML → AI-читаемый контент → JSON-LD → production.

YAML Frontmatter

Markdown vs Gutenberg: чистота кода

Markdown: 100 байт → 120 байт HTML

`**жирный текст**` → `жирный текст`. Один семантический тег.

Gutenberg: 100 байт → 350+ байт HTML

текст

`. Мусор.

Результат: -60% размера

56 Markdown-страниц → 8.2KB каждая. Gutenberg: 20KB+. Быстрее загрузка, лучше SEO.

Форматирование контента в GitHub CMS

Элемент	Markdown-синтаксис	Результат
Заголовки	# H1 ## H2 ### H3	Семантическая структура для AI
Жирный/курсив	жирный курсив	strong / em (семантические теги)
Списки	- пункт 1. нумерованный	ul/ol — AI парсит структуру
Ссылки	[текст](url)	SEO-ценные ссылки
Изображения	![alt](url)	img с alt (SEO + a11y)
Код	`inline` ```block```	code / pre — технический контент
Цитаты	> цитата	blockquote — семантическая цитата
@block	<!-- @block: answer-first -->	AI-разметка для Featured Snippets

Кейсы: Markdown в реальных проектах

📝

B2B-платформа, 57 стр.

Задача: Мигрировать контент из WordPress Gutenberg.

Решение: Экспорт в .md → очистка мусорных тегов → Markdown + YAML.

-60%

Размер

+40%

Скорость

Срок: 2 недели

🤖

EdTech, 180 стр.

Задача: Контент должен быть AI-читаемым.

Решение: Markdown + @block-директивы + авто-JSON-LD.

+60%

AI-цитир.

Git

Версии

Срок: 1 неделя

💻

DevOps-команда

Задача: Документация с версионированием.

Решение: .md в Git → GitHub PR review → CI/CD деплой.

Lock-in

100%

Git

Срок: 3 дня

8 выгод Markdown как контент-стратегии

◆

+40% скорость — текстовый формат

Без отвлечения на интерфейс. [GitHub, 2025]

◆

Git-версионирование контента

commit, diff, blame, revert. Полная история. [Git]

◆

Чистый HTML — -60% размера

Без мусорных тегов WYSIWYG. [markdown-it]

◆

0 vendor lock-in

.md файлы — открываются чем угодно. [формат открыт]

◆

Авто-JSON-LD из Frontmatter

title, author, schema_type → Schema.org. [useSeo.ts]

◆

@block-директивы — +60% AI

AI точно знает что цитировать. [SearchBridge AI, 2026]

◆

sanitize-html — защита от XSS

Безопасный HTML при сборке. [sanitize-html]

◆

markdown-it — семантический HTML

# → h1, ** → strong, ul/li. [markdown-it]

Roadmap: от нуля до Markdown-контента

Этап	Фаза	Действия	Результаты
1	Клонирование	git clone → npm ci → site-setup.txt	Готовый сайт, 5 мин
2	Первая статья	Создать content/blog/статья.md → Frontmatter → текст	Страница + JSON-LD, 10 мин
3	@block-директивы	Добавить answer-first, howto, faq в .md	+60% AI-цитирование, 5 мин
4	git push → деплой	git push → CI/CD → rsync → production	Сайт обновлён, 2 мин

FAQ по Markdown в GitHub CMS

Почему Markdown, а не Google Docs?

Google Docs — vendor lock-in, мусорные теги при экспорте в HTML, нет версионирования. Markdown: текстовые файлы в Git, чистый HTML при рендеринге, AI-читаемость.

Чем Markdown лучше Gutenberg?

Gutenberg: вложенные span/div, комментарии wp:block, размер +60%. Markdown: чистый семантический HTML, -60% размера, AI парсит мгновенно.

Можно ли использовать HTML в Markdown?

Да. markdown-it с опцией html: true поддерживает HTML-теги внутри .md. GitHub CMS использует это для raw_html статей (article-1..5 шаблоны). sanitize-html очищает опасные теги.

Как работает YAML Frontmatter?

Метаданные между --- в начале .md файла. gray-matter парсит YAML → поля доступны в useSeo.ts → генерируются OG-теги и JSON-LD. 10+ полей: title, author, schema_type, date.

Что такое @block-директивы?

HTML-комментарии в Markdown: . Сообщают AI какой блок цитировать. 7 типов: answer-first, howto, faq, definition, list, table, comparison.

Как мигрировать с WordPress на Markdown?

Экспорт WordPress → XML → конвертация в .md через скрипты. Очистка мусорных тегов. Добавление YAML Frontmatter и @block-директив. Кейс: 57 страниц за 2 недели.

Как писать Markdown без ошибок?

VS Code с preview (Ctrl+Shift+V). Или Obsidian, Typora. GitHub CMS: валидация Frontmatter при билде — 10 тестов на структуру. Ошибка → билд падает с указанием файла и строки.

Нужно ли знать HTML для Markdown?

Нет. Базовый синтаксис: # заголовки, **жирный**, - списки — 5 минут на освоение. Расширенный: таблицы, код, @block-директивы. GitHub CMS: 45+ промпт-шаблонов генерируют HTML через ChatGPT за 2 минуты.

Начните писать в Markdown сегодня — получите AI-видимость завтра

Клонируйте GitHub CMS — и каждая .md статья автоматически станет AI-оптимизированной страницей с JSON-LD, OG-тегами и sitemap. Без плагинов, без мусорных тегов.

+40%

Скорость

Мусора

Читаем

Клонировать на GitHub Раздел Контент