Шпаргалка з Markdown: синтаксис GitHub-Flavored Markdown із прикладами

Markdown — найпростіший спосіб писати форматований текст, який лишається читабельним і як звичайний текст. Його використовують README-файли, документація, нотатки, повідомлення в чатах і статичні сайти. У цій шпаргалці — синтаксис, яким ви справді користуватиметеся, з акцентом на GitHub-Flavored Markdown (GFM) — діалект, який підтримують GitHub, GitLab, більшість інструментів для документації та Markdown Preview Editor.

Кожен приклад нижче можна вставити в онлайн-редактор і побачити результат поруч.

Заголовки

Почніть рядок з одного–шести символів # і пробілу. Один # — назва сторінки, ## — розділ, ### — підрозділ.

markdown# Назва сторінки
## Розділ
### Підрозділ
#### Менший заголовок

Використовуйте лише один заголовок # на документ і не пропускайте рівні (наприклад, з ## одразу на ####). Програми читання з екрана й пошукові системи орієнтуються на структуру заголовків, а більшість переглядачів будує з неї зміст.

Абзаци й перенесення рядків

Абзац — це один або кілька рядків тексту, відокремлених порожнім рядком. Одиночне перенесення рядка всередині абзацу ігнорується — рядки зливаються. Щоб примусово перенести рядок, завершіть його двома пробілами або зворотною скісною рискою:

markdownПерший рядок із двома пробілами в кінці  
Другий рядок у тому самому абзаці.

Новий абзац починається після порожнього рядка.

Виділення тексту

Багато редакторів, зокрема Markdown Preview Editor, підтримують і кілька популярних розширень: ==виділення==, H~2~O для нижнього індексу, x^2^ для верхнього й емодзі-коди на кшталт :smile:. Вони не входять до самого GFM, тож перевірте цільову платформу, перш ніж на них покладатися.

Списки

Для маркованих списків використовуйте -, * або +, для нумерованих — числа. Щоб зробити вкладений пункт, додайте відступ у два–чотири пробіли.

markdown- Молоко
- Хліб
  - Цільнозерновий
  - Житній
- Кава

1. Клонувати репозиторій
2. Встановити залежності
3. Запустити збирання

Нумерованим спискам не потрібні правильні числа — 1. у кожному рядку все одно відобразиться як 1, 2, 3. Якщо почати з іншого числа (наприклад, 5.), список почнеться з нього.

Списки завдань

Списки завдань — розширення GFM, що перетворює пункти списку на прапорці. Вони ідеальні для README, планів релізів і нотаток зустрічей.

markdown- [x] Написати чернетку
- [x] Додати скриншоти
- [ ] Опублікувати допис

Посилання

markdown[Текст посилання](https://example.com)
[Посилання з підказкою](https://example.com "Показується під час наведення")
<https://example.com>

Прочитайте [посібник зі встановлення][install].

[install]: https://example.com/docs/install

Остання форма — посилання-виноска (reference link): URL задається один раз унизу документа, і довгі абзаци лишаються читабельними. Відносні посилання на кшталт [Setup](docs/setup.md) ведуть до інших файлів того самого проєкту; у Markdown Preview Editor вони перемикають на цей документ, якщо він відкритий в іншій вкладці.

Зображення

Зображення записуються як посилання зі знаком оклику попереду. Текст у квадратних дужках — альтернативний текст: опишіть зображення для тих, хто його не бачить.

markdown![Редактор із живим переглядом](images/screenshot.png)
![Логотип](https://example.com/logo.svg "Необов’язкова підказка")

Коли переглядаєте документ із локальними зображеннями, відкрийте всю папку або перетягніть зображення разом із .md-файлом, щоб переглядач зміг розпізнати відносні шляхи.

Код

Код у рядку позначається одинарними зворотними апострофами. Для блоків обгорніть код потрійними зворотними апострофами й додайте назву мови для підсвічування синтаксису:

markdown```js
function greet(name) {
  return `Hello, ${name}!`;
}
```

Поширені назви мов: js, ts, python, bash, json, yaml, html, css, sql, go, rust, diff. Якщо сам код містить потрійні зворотні апострофи, обгорніть його чотирма, як у прикладі вище.

Таблиці

Розділяйте стовпці вертикальними рисками, а під заголовком поставте рядок із дефісів. Двокрапки в рядку-розділювачі задають вирівнювання.

markdown| Функція  | Безкоштовно | Примітки                   |
|:---------|:-----------:|---------------------------:|
| Перегляд |     ✅      | Оновлюється під час набору |
| Експорт  |     ✅      | HTML, PDF, .md             |

:--- вирівнює ліворуч, :---: — по центру, ---: — праворуч. Стовпці не мусять збігатися у вихідному тексті, але хороший редактор тримає їх читабельними. У Markdown Preview Editor на панелі інструментів є кнопка таблиці, що вставляє готовий шаблон.

Цитати й попередження

Щоб процитувати текст, почніть рядки з >. GitHub також підтримує попередження (alerts) — цитати зі спеціальним першим рядком, які відображаються як кольорові блоки:

markdown> Звичайна цитата.

> [!NOTE]
> Корисна інформація, яку варто знати.

> [!TIP]
> Порада, як зробити щось краще.

> [!WARNING]
> Термінова інформація, що потребує негайної уваги.

Є п’ять типів попереджень: NOTE, TIP, IMPORTANT, WARNING і CAUTION. Використовуйте їх помірно: одне попередження на розділ помітне, п’ять поспіль перетворюються на шум.

Виноски

Виноски виносять побічні зауваження з основного тексту. Саму примітку можна визначити будь-де — вона відобразиться в кінці документа.

markdownMarkdown створили 2004 року.[^1]

[^1]: Джон Ґрубер за участі Аарона Шварца.

Горизонтальні лінії та екранування

Три або більше дефісів, зірочок чи підкреслень в окремому рядку створюють горизонтальну лінію: ---. Поставте перед нею порожній рядок, інакше --- під рядком тексту перетворить цей текст на заголовок.

Щоб показати символ, який Markdown інакше інтерпретував би, екрануйте його зворотною скісною рискою: \*не курсив\*, \# не заголовок, \$5 (корисно, коли ввімкнено формули).

Формули й діаграми

Два розширення стали стандартом у технічних текстах:

• Формули — $E = mc^2$ для формул у рядку та $$ … $$ для окремих рівнянь. Докладніше — у посібнику про формули в Markdown.
• Діаграми — блок коду з мовою mermaid малює блок-схеми, діаграми послідовностей, діаграми Ганта та інше. Докладніше — у статті Діаграми Mermaid у Markdown.

Front matter

Генератори статичних сайтів читають метадані з блоку YAML на самому початку файлу:

yaml---
title: Мій допис
date: 2026-09-27
tags: [markdown, docs]
---

Хороший переглядач приховує цей блок, а не показує його як текст. Markdown Preview Editor робить саме так.

Що далі

Знати синтаксис — це половина справи; друга половина — бачити результат під час письма. Прочитайте, як переглядати Markdown онлайн, не завантажуючи файли, а коли документ буде готовий, дізнайтеся, як конвертувати Markdown у HTML чи PDF.