Що робить інструмент
Конвертер Markdown у HTML перетворює текст Markdown на HTML-розмітку, яку можна вставити в CMS, шаблон листа, статичну сторінку чи будь-куди, де приймають HTML, але не Markdown. Він стане в пригоді, щоб опублікувати README на сайті, перенести нотатки в редактор блогу або точно з’ясувати, які теги дає фрагмент Markdown.
Результат збігається з HTML популярних рендерерів Markdown: заголовки від <h1> до <h6>, абзаци <p>, списки <ul> і <ol>, блоки <pre><code> з класом language- для підсвічування синтаксису та розмітка <table> для таблиць у стилі GitHub.
Як користуватися
- Введіть або вставте Markdown, завантажте файл
.mdабо натисніть Приклад. - Виберіть потрібні опції: GitHub Flavored Markdown, розриви рядків як
<br>, ID заголовків для посилань-якорів, очищення для недовіреного введення та повний HTML-документ замість фрагмента. - Скопіюйте HTML або завантажте його як файл
.html.
Результат оновлюється під час введення. Вимкніть опцію повного документа, якщо вставляєте результат в наявну сторінку, і ввімкніть її, коли потрібен окремий файл.
Приклад
Цей Markdown:
## Install
Run the **installer** and read the [guide](https://example.com).
- Windows
- macOS
перетворюється на такий HTML:
<h2>Install</h2>
<p>Run the <strong>installer</strong> and read the <a href="https://example.com">guide</a>.</p>
<ul>
<li>Windows</li>
<li>macOS</li>
</ul>
Поради
- Типово сирий HTML усередині Markdown лишається як є — так робить більшість рендерерів. Вмикайте очищення щоразу, коли Markdown написав хтось інший.
- З ID заголовків можна посилатися на розділ за адресою на кшталт
page.html#installі будувати зміст за заголовками. - Блоки коду зберігають мову у вигляді класу, тому підсвічувачі як-от Prism чи highlight.js розпізнають їх без додаткового налаштування.
- Щоб бачити результат поруч, скористайтеся попереднім переглядом Markdown. Для зворотного напрямку є конвертер HTML у Markdown.
Часті запитання
› Який синтаксис Markdown підтримується?
Увесь CommonMark — заголовки, виділення, посилання, зображення, списки, цитати, код і горизонтальні лінії. З увімкненим GitHub Flavored Markdown доступні також таблиці з вирівнюванням стовпців, списки завдань, закреслення та автоматичні посилання для голих URL.
› Що робить опція очищення?
Вона екранує весь сирий HTML у Markdown, щоб він показувався як текст, а не ставав тегами, і видаляє посилання й зображення з небезпечною схемою URL, як-от javascript чи vbscript. Вмикайте її, коли Markdown написали користувачі, яким ви не довіряєте, наприклад у коментарях чи на форумі.
› Як створюються ID заголовків?
Так само, як на GitHub. Текст заголовка переводиться в нижній регістр, розділові знаки видаляються, а пробіли замінюються дефісами, тож Getting Started отримує id getting-started. Повторювані заголовки отримують -1, -2 і так далі, тому кожен якір унікальний.
› Навіщо опція повного HTML-документа?
Вона обгортає результат у цілу сторінку з doctype, кодуванням UTF-8, тегом viewport, заголовком title з першого заголовка першого рівня та невеликою зручною для читання таблицею стилів. Збережіть її як файл .html, і вона охайно відкриється в будь-якому браузері.
› Чи надсилається мій Markdown кудись?
Ні. Перетворення виконується у браузері за допомогою бібліотеки marked, і нічого не завантажується на сервер.