HTML в Markdown

Конвертер HTML в Markdown онлайн, бесплатно

Вставьте HTML слева или скопируйте страницу, документ Word либо текст из Google Docs и вставьте его, и сразу получайте Markdown справа. Инструмент сделан для текстов, которые вы публикуете в Hugo, Astro, Grav и похожих движках. Всё происходит в вашем браузере: текст никуда не загружается.

Как работает конвертер

• Читает HTML как браузер. HTML разбирает сам браузер в безопасном документе, где ничего не запускается и не загружается, а структура конвертируется элемент за элементом. Поэтому вложенные списки, ссылки внутри списков и теги, растянутые на несколько строк, обрабатываются верно, а конвертеры на регулярных выражениях на них ломаются.
• Что становится Markdown: заголовки, абзацы, жирный и курсив, ссылки, изображения, нумерованные и маркированные списки (в том числе вложенные), цитаты, строчный код и блоки кода (язык берётся из class="language-js"), горизонтальные линии и таблицы. Символы текста, которые читались бы как Markdown, например звёздочки или квадратные скобки, экранируются.
• Вставка со страницы, из Word или Google Docs. Когда вы вставляете форматированный текст, используется HTML, который за ним стоит. Жирный и курсив, которые Word и Google Docs записывают стилями, распознаются. Когда вы вставляете исходный HTML, например из редактора, он воспринимается как текст.
• Таблицы и зачёркивание. Настройка «GFM» по умолчанию записывает таблицы как таблицы Markdown, а зачёркивание как ~~text~~, и Hugo, Astro и Grav это читают. Настройка «Строгий» оставляет таблицы и зачёркивание в виде HTML, что классический Markdown допускает.
• Front matter. Если в HTML есть тег <title> и мета-тег описания (<meta name="description">), в начало ставится блок YAML с title и description, как ожидают Hugo, Astro и Grav. Отсутствующий тег пропускается, ничего не придумывается, а без обоих тегов front matter нет. Всё до </head> пропускается как заголовок страницы, а если </head> нет, то всё до <body; конвертация начинается после этого.

Ограничения

• В Markdown нельзя выразить всё, что есть в HTML. Стили, классы и цвета теряются. Элементы, для которых в Markdown нет синтаксиса, такие как iframe, видео, аудио, верхний и нижний индекс и выделение маркером, остаются в виде HTML. Таблицы с объединёнными ячейками или со списками и заголовками внутри ячеек тоже остаются HTML-таблицами.
• Ваш движок может скрывать сырой HTML. Hugo, например, по умолчанию не выводит сырой HTML из Markdown. Если какие-то части не появляются, проверьте настройку движка.
• Контейнеры отбрасываются. Теги вроде div, span и section исчезают, остаются только их текст и структура. Кнопки, формы, скрипты, стили и встроенная графика не конвертируются.
• Списки из Word, набранные символами вручную (абзац, который начинается с точки или тире вместо настоящего списка), невозможно отличить от обычных абзацев, и они конвертируются как абзацы.
• В front matter только два ключа. Схема у каждого сайта своя, поэтому записываются только title и description. Дату, теги, рубрики или черновик добавьте вручную.