Конвертер HTML в Markdown
Превратите HTML в чистый, читаемый Markdown.
Работает в браузере. То, что вы вводите, никуда не отправляется.
- Заголовки и списки сохраняются
- Блоки кода в оградах
- Ничего не загружается
Как конвертировать HTML в Markdown
- Вставьте свой HTML.
- Markdown появляется по мере ввода.
- Скопируйте или скачайте файл Markdown.
Как конвертируются элементы
| HTML | Markdown |
|---|---|
| <h2>Заголовок</h2> | ## Заголовок |
| <strong>жирный</strong> | **жирный** |
| <a href="...">текст</a> | [текст](...) |
| <code>x</code> | `x` |
| <pre><code>...</code></pre> | блок кода в ``` оградах |
Что конвертируется не идеально
- Таблицы HTML переносятся как обычный текст, а не синтаксис таблиц Markdown.
- Встроенные стили и классы CSS отбрасываются, ведь у Markdown нет для них эквивалента.
- Блоки div для разметки и другой нестандартный структурный HTML превращаются в обычные абзацы.
- Повторяющиеся пробелы и переносы строк, использованные только для визуального отступа, схлопываются в один пробел, точно как обычно поступает браузер с лишними пробелами в HTML.
Где используется конвертированный Markdown
- Вставка веб-страницы в README или вики, которые принимают только Markdown.
- Передача очищенного контента в генератор статических сайтов.
- Перенос документации из экспорта CMS в инструмент документации на основе Markdown.
- Очистка форматированного текста, вставленного из письма, перед добавлением в обычный текстовый changelog.
Стиль вывода Markdown
- Заголовки используют стиль # (ATX), а не более старый стиль с подчёркиванием === или ---.
- Блоки кода используют ограды из тройных обратных кавычек, а не отступ в 4 пробела.
- Жирный текст использует **, а курсив *, что соответствует стилю Turndown по умолчанию.
Частые вопросы о HTML в Markdown
Какие элементы HTML конвертируются хорошо?
Заголовки, абзацы, списки, ссылки, изображения, жирный и курсивный текст, цитаты и блоки кода конвертируются чисто.
Таблицы HTML конвертируются?
Не в синтаксис таблиц Markdown. Таблицы переносятся как их текстовое содержимое, ведь поддержка таблиц в Markdown сильно различается между инструментами.
Можно вставить целую веб-страницу?
Да. Вставьте исходный HTML страницы, и читаемое содержимое конвертируется в Markdown.
Какая библиотека это обеспечивает?
Turndown, широко используемый конвертер HTML в Markdown, настроенный на заголовки в стиле ATX (# Заголовок) и блоки кода в оградах.
Обрабатываются ли вложенные списки?
Да. Вложенные элементы <ul> и <ol> конвертируются в элементы списка Markdown с отступом, сохраняя уровень вложенности.
Конвертируются ли HTML-сущности вроде & или ?
Да, частые сущности конвертируются в свои обычные символы в результате Markdown, поэтому & становится буквальным &, а становится обычным пробелом.
Что происходит с цитатами и горизонтальными линиями?
<blockquote> становится строкой, начинающейся с >, а <hr> становится строкой из трёх дефисов, оба варианта это стандартный синтаксис Markdown.
Можно конвертировать HTML, скопированный прямо из Word или Google Документов?
Да, хотя источник часто несёт лишние теги span и встроенные стили для форматирования. Они отбрасываются, ведь у Markdown нет для них эквивалента, а видимый текст, заголовки, ссылки и списки остаются нетронутыми.