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

YAML Frontmatter — полный справочник 15 полей GitHub CMS за 2 минуты

title, description, slug, author, category, tags, schema_type, raw_html и другие. Каждое поле напрямую влияет на JSON-LD, Open Graph и SEO-метатеги.

Все поляFAQ
15
полей
2 мин
на заполнение
10+
типов JSON-LD
0
плагинов
auto
→ JSON-LD

Три уровня полей YAML Frontmatter

Обязательные → рекомендуемые → продвинутые

📝
Обязательные: 4 поля

title, description, slug, date — без них билд упадёт. Заполняются за 30 секунд. Формируют заголовок H1, мета-description, URL страницы и дату публикации в sitemap и JSON-LD.

🔑
Рекомендуемые: 6 полей

author, category, schema_type, tags, layout, cover_image. Влияют на JSON-LD Person, E-E-A-T, категоризацию и OG-изображение. +40-60% AI-цитирования.

⚡
Продвинутые: 5 полей

raw_html, geo, updated, certifications, sources. Специальные возможности: сырой HTML вместо markdown, GEO-координаты, дата обновления, E-E-A-T сигналы.

Как Frontmatter превращается в JSON-LD и SEO

1

gray-matter парсит YAML

Блок между --- в .md файле → объект с полями. 0.1 миллисекунды на парсинг.

2

useSeo.ts → JSON-LD + OG

title → og:title + headline. author → JSON-LD Person. schema_type → @type.

3

npm run build → всё в HTML

JSON-LD, OG, meta, sitemap — генерируются при сборке. Без плагинов.

6 ключевых полей и их влияние на SEO/GEO

Как каждое поле работает в JSON-LD и мета-тегах

📝
title

→ og:title + headline

H1 страницы + JSON-LD headline + og:title. Максимум 70 символов. Главный SEO-фактор контента.

🔍
description

→ meta + og:description

Мета-description + JSON-LD description. 120-160 символов. Сниппет в Google и AI-поисковиках.

🔗
slug

→ URL страницы

ЧПУ: /blog/мой-слаг/. Только латиница, цифры, дефисы. Валидируется при билде — не пройдёт с пробелами.

👤
author

→ JSON-LD Person

Генерирует JSON-LD Person с name, url, image. Ключевой E-E-A-T сигнал: +40-60% AI-цитирования.

📐
schema_type

→ JSON-LD @type

Article, HowTo, FAQPage, BlogPosting. Определяет структуру JSON-LD. Влияет на Featured Snippets.

📅
date

→ sitemap lastmod

Дата публикации в sitemap.xml → datePublished в JSON-LD. Формат: YYYY-MM-DD. Валидируется при билде.

Три категории полей: от базовых до GEO

Как поля группируются по назначению

1

SEO-поля

title, description, slug, date, updated — формируют мета-теги, canonical URL, sitemap lastmod и og:title/description. Это база: без них страница не будет индексироваться правильно.

  • Обязательный минимум: title, description, slug, date
  • updated — дата последнего изменения (sitemap)
2

JSON-LD-поля

author, schema_type, tags, category, certifications, sources — напрямую генерируют JSON-LD Schema.org: Person, Article, sameAs, knowsAbout. E-E-A-T сигналы для AI-поисковиков.

  • author → JSON-LD Person (Experience)
  • schema_type → @type (Article, HowTo, FAQPage)
3

GEO и специальные поля

raw_html, geo, cover_image, layout — управляют отображением и AI-видимостью. raw_html: true отключает markdown-it, использует тело как готовый HTML. geo: {lat, lng} → JSON-LD Place.

  • raw_html — для article-1..5 шаблонов
  • geo — координаты для локального SEO

Эволюция YAML Frontmatter

5 этапов развития метаданных для статических сайтов

1

2008 — Jekyll и появление Frontmatter

Jekyll вводит YAML Frontmatter для статических сайтов: блок между --- с метаданными. 3 поля: title, layout, date. Стандарт для всех SSG.

2008
2

2014 — gray-matter и Node.js

Библиотека gray-matter для Node.js: парсинг YAML/JSON/TOML Frontmatter. Используется в Metalsmith, Gatsby, Hexo. 10+ полей становятся стандартом.

2014
3

2019 — SEO-интеграция

Frontmatter напрямую генерирует мета-теги: title → og:title, description → meta-description. Gatsby, Next.js используют это для SSR/SSG.

2019
4

2023 — JSON-LD и Schema.org

Frontmatter генерирует JSON-LD: author → Person, schema_type → @type. WordPress требует плагины ($150-400/год). Статические сайты делают это из коробки.

2023
5

2026 — GitHub CMS: 15 полей → всё

15 полей YAML Frontmatter генерируют: JSON-LD 10+ типов, OG-теги, sitemap, RSS. @block-директивы для AI. raw_html для промпт-шаблонов. Заполнение: 2 минуты.

2026

Как author и schema_type превращаются в JSON-LD Person

Поле author в YAML Frontmatter автоматически генерирует JSON-LD Person со связью к Organization. schema_type определяет @type: Article, HowTo, FAQPage. AI видит: кто написал, какая структура, можно ли доверять.

Person

из author

@type

из schema_type

FAQ по Frontmatter

4 шага заполнения Frontmatter

От пустого файла до AI-оптимизированной страницы

1
Создать .md файл

content/blog/статья.md или content/sections/имя.md. Добавить --- в начале.

30 сек
2
Заполнить обязательные

title, description, slug, date. 4 поля — основа. Без них билд упадёт.

30 сек
3
Добавить рекомендуемые

author, schema_type, tags, category. +40-60% AI-цитирования.

30 сек
4
git push → деплой

npm run build: JSON-LD + OG + sitemap. Страница в продакшене.

2 мин

Отзывы: YAML Frontmatter в реальных проектах

Результаты использования GitHub CMS Frontmatter

АК

Алексей К.

CEO B2B-платформы

«57 страниц — заполнили Frontmatter за час. JSON-LD генерируется автоматически. Раньше на WordPress каждый плагин требовал ручной настройки. author → Person, schema_type → Article — всё из одного YAML-блока.»

МС

Марина С.

Техдир EdTech

«Frontmatter — это гениально просто. Заполнил 15 полей за 2 минуты и забыл. useSeo.ts сам генерирует OG-теги, JSON-LD, sitemap. Валидация при билде отлавливает ошибки: slug с пробелами, дата не в формате. WordPress о таком может только мечтать.»

ДВ

Дмитрий В.

DevOps, FinTech

«raw_html: true — лучшее, что случилось с контентом. Пишем HTML по article-шаблонам через ChatGPT и вставляем в .md тело. Без markdown-it, без ограничений. Frontmatter только для метаданных, тело — чистый HTML. Идеальное разделение.»

ОИ

Ольга И.

Маркетолог E-commerce

«tags работают как надо: добавила 5 тегов в Frontmatter → автоматически сгенерировались страницы тегов (/tag/seo/, /tag/markdown/). Категории тоже. 11 статей — 24 страницы тегов и категорий. Без плагинов, без таксономий WordPress.»

FAQ по YAML Frontmatter

Частые вопросы о заполнении метаданных

Какие поля Frontmatter обязательны?+

4 обязательных поля: title (≤70 символов), description (120-160 символов), slug (латиница, цифры, дефисы), date (YYYY-MM-DD). Без них валидация контента при билде вернёт ошибку. Эти поля формируют H1, мета-description, URL и дату публикации в sitemap.

Как author влияет на JSON-LD?+

Поле author автоматически генерирует JSON-LD Person с полями: name, url, image, sameAs, worksFor (Organization). AI-поисковики парсят это и видят: кто написал статью, какой у автора опыт, где он работает. E-E-A-T сигнал Experience. Результат: +40-60% AI-цитирования (SearchBridge AI, 2026).

Какие значения schema_type поддерживаются?+

Article (стандартная статья), HowTo (пошаговая инструкция → JSON-LD HowTo), FAQPage (вопросы-ответы → JSON-LD FAQPage), BlogPosting (блог-пост), NewsArticle (новостная статья), TechArticle (техническая статья). Валидация при билде проверяет schema_type на соответствие списку.

Зачем нужно поле raw_html?+

raw_html: true отключает рендеринг через markdown-it. Тело .md файла используется как готовый HTML напрямую. Это для статей, сгенерированных по промпт-шаблонам article-1..5 через ChatGPT. Frontmatter содержит только метаданные, тело — готовый HTML с Bootstrap-классами и inline-стилями.

Как tags и category влияют на сайт?+

tags (массив строк) и category (строка) автоматически генерируют страницы /tag/имя/ и /category/имя/. Каждая такая страница — список статей с этим тегом/категорией. JSON-LD: tags → about/mentions, category → articleSection. Валидация: tags должен быть массивом, не строкой.

Как валидируется Frontmatter при билде?+

10 тестов: title ≤70 символов, slug только латиница/цифры/дефисы, date в формате YYYY-MM-DD, schema_type из списка, tags — массив, не строка. Секретные ключи во Frontmatter (VITE_*, SECRET_*) вызывают ошибку. Дубликаты @block-маркеров. Результат: билд с ошибками не пройдёт.

Можно ли добавить свои поля в Frontmatter?+

Да. Любые дополнительные поля в YAML Frontmatter доступны через gray-matter. Вы можете добавить custom_field: value и использовать его в Vue-компонентах. Стандартные поля (title, author, schema_type) обрабатываются useSeo.ts автоматически. Кастомные поля игнорируются JSON-LD, но доступны в шаблонах.

Что будет если не заполнить Frontmatter?+

Без обязательных полей билд упадёт с ошибкой валидации. Без рекомендуемых полей (author, schema_type) страница сгенерируется, но без JSON-LD Person и правильного @type — AI-цитирование будет на 40-60% ниже. Без tags/category не сгенерируются страницы тегов и категорий. Заполните минимум 4 обязательных поля.

Frontmatter → JSON-LD: полная цепочка

◆

YAML → gray-matter → объект

--- блок парсится в объект JavaScript. Все поля доступны как parsed.data.

◆

Объект → useSeo.ts → JSON-LD

author → Person, schema_type → @type, tags → about. 10+ типов Schema.org.

◆

JSON-LD → <script> в HTML

Встраивается в head каждой страницы. AI-краулеры парсят напрямую за 0.3 секунды.

Markdown-обзор →

6 выгод YAML Frontmatter перед WordPress

Почему метаданные в Markdown выигрывают у плагинов

✓
15 полей → авто-JSON-LD

Без плагинов. WordPress: Yoast + Schema Pro ($168-728/год).

✓
Валидация при билде — 10 тестов

WordPress: ошибки обнаруживаются в продакшене.

✓
2 минуты — все поля заполнены

WordPress: SEO-плагины требуют 10-15 мин на страницу.

✓
raw_html — готовый HTML в теле

Для ChatGPT-сгенерированных статей article-1..5.

✓
Git-версионирование метаданных

commit, diff, revert. WordPress: метаданные в MySQL.

✓
10+ типов Schema.org из коробки

WordPress: каждый тип — отдельный плагин.

Заполните Frontmatter за 2 минуты — получите JSON-LD из коробки

Клонируйте GitHub CMS — 15 полей YAML Frontmatter генерируют всё: SEO-метатеги, JSON-LD 10+ типов, Open Graph, sitemap. Без плагинов, без подписок.

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

Бесплатно · MIT лицензия · 15 полей · 2 минуты · → JSON-LD

Markdown-обзор →

Чистый HTML, +40% скорость, версионирование через Git.

Промпт-шаблоны →

45+ шаблонов для AI-генерации контента.

AI-контент →

7 этапов + дебат агентов для статей 180KB+.

Статья из Раздела 3: Контент / Markdown. Создана по промпт-шаблону article-2.txt (HOME-4 стиль). YAML Frontmatter — полный справочник полей GitHub CMS.