Продвинутый Markdown в GitHub CMS: @block-директивы, frontmatter-контракт, вложенные HTML-блоки

GitHub CMS использует Markdown как основной формат контента, но с существенными расширениями: frontmatter-контракт на YAML задаёт метаданные и SEO, @block-директивы (answer-first, key-facts, faq, cta) структурируют контент для AI, а вложенные HTML-блоки позволяют создавать сложную вёрстку без выхода из Markdown. Всё это собирается в статический HTML с JSON-LD за один билд.

Продвинутый Markdown

Frontmatter-контракт: полный справочник полей

ПолеОбязательноеНазначение
titleДаЗаголовок страницы — попадает в <title> и JSON-LD
descriptionДаОписание 120-160 символов для JSON-LD и Open Graph
slugДаURL-путь: /blog/moj-slug/
dateДаДата публикации YYYY-MM-DD
schema_typeНетArticle, FAQPage, HowTo, WebSite и др.
cover_imageНетURL обложки для Open Graph и карточки статьи
geoНетМассив: [answer-first, key-facts, faq, cta]
raw_htmlНетtrue — весь контент рендерится как HTML (для лендингов)

@block-директивы: 4 формата для AI

@block answer-first

Главный тезис в начале статьи. AI извлекает ответ из первых 150-200 слов. Без этого блока вероятность цитирования падает на 60%.

@block key-facts

Ключевые факты в структурированном виде. Идеально для Featured Snippets и AI-суммаризации.

@block faq

Вопросы-ответы. Автоматическая FAQPage Schema.org разметка. Прямой путь в Featured Snippets.

@block cta

Призыв к действию в конце статьи. Конверсия читателя в пользователя GitHub CMS.

FAQ

Можно ли использовать обычный HTML внутри Markdown?

Да. GitHub CMS позволяет вставлять HTML-блоки напрямую в Markdown: таблицы со стилями, flex-сетки, div с inline-стилями. Это особенно полезно для лендингов (raw_html: true).

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

GitHub CMS Pro — все @block-директивы и frontmatter-контракт из коробки.