Перетворити та переглянути Markdown

Панель керування
Документація
API

перетворює ваш Markdown на HTML і показує попередній перегляд у реальному часі, ідеально для написання файлів README, документації або статей

Що таке Markdown?

Markdown - це полегшена мова розмітки, створена Джоном Грубером у 2004 році. Вона дозволяє писати форматований текст за допомогою простого та читабельного в сирому вигляді синтаксису, який потім перетворюється на HTML.

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

Попередній перегляд праворуч оновлюється в реальному часі під час набору тексту. Кнопка Надіслати генерує відповідний HTML-код, який ви можете скопіювати або завантажити.

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

Markdown	Результат
`# Заголовок 1`	Заголовок <h1>
`## Заголовок 2`	Заголовок <h2>
`жирний`	жирний
`курсив`	курсив
`вбудований код`	`вбудований код`
```php ... ```	Блок коду PHP
`[текст](url)`	Гіперпосилання
`![alt](url)`	Зображення
`- елемент`	Невпорядкований список
`1. елемент`	Впорядкований список
`> цитата`	Blockquote
`---`	Горизонтальний роздільник

Поширені випадки використання

README на GitHub: написання документації проєкту з відкритим кодом.
Технічна документація: написання посібників, вікі або сторінок документації (MkDocs, Docusaurus, Hugo).
Статті блогу: більшість систем CMS (Jekyll, Ghost, Contentful) підтримують Markdown.
Коментарі та issues: GitHub, GitLab, Jira, Notion і Slack підтримують GFM.
Форматовані електронні листи: перетворення Markdown на HTML для вставки в HTML-лист.
Нотатки та презентації: Obsidian, Notion, Marp і Reveal.js використовують Markdown.

Поширені запитання

Яка різниця між стандартним Markdown і GFM?

Стандартний Markdown (CommonMark) охоплює базові елементи: заголовки, списки, посилання, код. GFM (GitHub Flavored Markdown) додає таблиці, списки завдань (- [ ] елемент), огороджений код із зазначенням мови (```php), згадки та автоматичні посилання. Цей інструмент використовує GFM через бібліотеку league/commonmark.

Чи безпечний згенерований HTML?

Так. Конвертер налаштований на видалення сирих HTML-тегів (html_input: strip) та блокування небезпечних посилань, що запобігає атакам XSS. Створений HTML придатний для інтеграції в наявну вебсторінку.

Чи можу я включати HTML у свій Markdown?

З міркувань безпеки сирий HTML, вставлений у Markdown, видаляється під час конвертації. Якщо вам потрібен власний рендеринг HTML, пишіть цільовий HTML безпосередньо.

Який максимальний розмір документа?

Для цього інструмента немає жорсткого обмеження на боці сервера. Для дуже довгих документів (понад кілька тисяч рядків) попередній перегляд у реальному часі може сповільнюватися залежно від вашого браузера.

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

curl -X POST https://cdrn.fr/api/v1/tools/markdown-formatter/execute \
  -H "Content-Type: application/json" \
  -d '{"input":"..."}'

Схема вхідних даних

Поле	Тип	Обов'язкове	За замовчуванням
`input`	text		–

Точки доступу

GET https://cdrn.fr/api/v1/tools - перелічує всі доступні інструменти
GET https://cdrn.fr/api/v1/tools/markdown-formatter - отримує схему цього інструменту
POST https://cdrn.fr/api/v1/tools/markdown-formatter/execute - виконує цей інструмент з JSON-payload