Що таке Markdown?

Markdown — легка мова розмітки, створена Джоном Грубером у 2004 році, що дозволяє писати форматований текст за допомогою синтаксису простого тексту. Вона розроблена так, щоб бути читабельною навіть у неформатованому вигляді: зірочки для акцентування, символи решітки для заголовків, тире для списків. Markdown широко використовується в документації (README на GitHub), застосунках для нотаток (Obsidian, Notion), блогінгових платформах та комунікації розробників.

Цей інструмент надає живий попередній перегляд Markdown під час введення. Ліва панель показує вихідний код Markdown, а права — в реальному часі відображає форматований вивід. Підтримується стандартний Markdown, розширення GitHub Flavored Markdown (GFM) (таблиці, списки завдань, закреслення, огороджені блоки коду) та підсвічування синтаксису для блоків коду.

Базовий синтаксис Markdown

• Заголовки: використовуйте # для H1, ## для H2, ### для H3 і так далі до ###### для H6.
• Жирний: обгорніть текст подвійними зірочками або підкресленнями. Курсив: використовуйте одинарні зірочки або підкреслення.
• Списки: починайте рядки з - або * для маркованих списків, або 1. для нумерованих. Вкладеність через відступ.
• Посилання: [текст посилання](URL). Зображення: .
• Код: використовуйте зворотні лапки для вбудованого коду, потрійні зворотні лапки для огороджених блоків коду з опціональною мовою для підсвічування синтаксису.

Як користуватися цим інструментом

Введіть або вставте Markdown в редактор. Попередній перегляд оновлюється в реальному часі. Можна перемикатися між режимами «поруч» та «лише перегляд». Інструмент підтримує копіювання в буфер обміну (і вихідний код Markdown, і відрендерений HTML), завантаження як .md файл та експорт як HTML.

GitHub Flavored Markdown

GitHub Flavored Markdown розширює стандартний Markdown таблицями (стовпці через вертикальну риску), списками завдань (прапорці з - [ ] та - [x]), закресленим текстом (обгорнутим подвійними тильдами), автоматичними посиланнями на URL та огородженими блоками коду з підсвічуванням синтаксису. Цей інструмент підтримує всі функції GFM, ідеально підходить для попереднього перегляду README та документації перед надсиланням на GitHub.

Приклад із практики

Введіть ## Setup в окремому рядку — і попередній перегляд відобразить заголовок 2-го рівня. Оточіть фразу подвійними зірочками — **зберігайте часто** — для жирного тексту, а рядки, що починаються з дефіса й пробілу, утворюють маркований список. Блок, відкритий трьома зворотними лапками та словом js, дає підсвічений код. Оскільки Markdown — це звичайний текст, той самий файл залишається читабельним у будь-якому редакторі й чисто перетворюється на HTML для вебу.

Поширені помилки

Найпоширеніша помилка — забути порожній рядок між абзацом і списком чи заголовком: без нього багато аналізаторів об'єднують їх в один блок. Вкладені списки потребують однакового відступу у два або чотири пробіли, а не табуляцій упереміш із пробілами. І хоча більшість варіантів Markdown дозволяють чистий HTML, кутові дужки, які мають бути буквальним текстом, як-от тег div, слід екранувати чи взяти у зворотні лапки, інакше вони зникнуть із результату.

Часті запитання

Чи можна використовувати HTML всередині Markdown?

Так. Стандартний Markdown дозволяє вбудований HTML для всього, що неможливо виразити синтаксисом Markdown (складні таблиці, кольоровий текст або вбудовані відео). Однак деякі рендерери Markdown (наприклад, GitHub) вилучають певні HTML-теги з міркувань безпеки. Цей інструмент попереднього перегляду відображає більшість HTML-тегів, щоб показати очікуваний результат.

У чому різниця між Markdown та форматованим текстом?

Форматований текст (як документи Word) зберігає форматування як приховані коди всередині файлу. Markdown зберігає форматування як видимі текстові символи — **жирний** буквально вводиться зірочками. Це робить файли Markdown портативними (будь-який текстовий редактор може їх прочитати), зручними для контролю версій (різниці чисті) та довговічними (жодного пропрієтарного формату).

Чи однаковий Markdown усюди?

Основний синтаксис стандартизовано специфікацією CommonMark, але діалекти різняться. GitHub Flavored Markdown додає таблиці, списки завдань і закреслення; інші платформи підтримують виноски чи математичні формули. Коли важлива переносимість, тримайтеся основ CommonMark і перевіряйте в цільовому рендерері.