Що таке 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.

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

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

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

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

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