Markdown в GitHub CMS: полный синтаксис и возможности

2026-05-08от GitHub CMS Team1 мин. чтенияДокументация markdown frontmatter documentation syntax

Поддерживаемые элементы Markdown

Элемент	Синтаксис	Примечание
Заголовки	`## H2`, `### H3`	H1 — только title из frontmatter
Жирный	`текст`
Курсив	`текст`
Ссылки	`[текст](url)`	target и rel сохраняются
Изображения	`![alt](url)`	PixInLink URL или любые публичные URL
Списки	`- пункт`	Вложенные списки поддерживаются
Таблицы	`\| A \| B \|`	Стандартный GitHub-flavored Markdown
Код	`inline`, ```блок```	Подсветка через атрибут языка
Горизонтальная линия	`---`	Только вне frontmatter

Ограничения HTML

HTML в Markdown проходит через санитайзер sanitize-html. Разрешены только безопасные теги:

a, img, section, article, p, h2-h6
ul, ol, li, table, thead, tbody, tr, td, th
strong, em, code, pre, blockquote
div, span (с id и class)

Запрещены: <script>, <iframe>, <style>, onclick, javascript: URL.

GitHub CMS расширяет стандартный Markdown тремя ключевыми возможностями: YAML frontmatter для метаданных, специальные блоки для структурирования контента, и публичные PixInLink URL для генерации изображений. Всё остальное — стандартный Markdown с безопасным HTML-санитайзером.

Структура Markdown-файла

---
title: "Заголовок статьи"
description: "Описание для SEO и превью"
slug: "url-статьи"
date: "2026-05-08"
author: "Имя автора"
category: "Категория"
tags:
  - тег1
  - тег2
schema_type: "Article"
layout: "article"
cover_image: "https://pixinlink.ru/api/v1/600x400/code-on-laptop-screen"
---

(блок: answer-first)
Краткий ответ на главный вопрос статьи.

(блок: key-facts)
## Ключевые факты
- Факт 1
- Факт 2

(блок: faq)
## FAQ
**Q: Вопрос?**
**A:** Ответ.

(блок: cta)
Призыв к действию.

FAQ

YouTube использует `