HTML в Markdown

Как это работает

Markdown нужен файлам README, трекерам задач, вики и статическим сайтам. HTML получается, когда вы копируете с веб-страницы или экспортируете из CMS. Переводить один в другой вручную утомительно, а результат обычно полон лишней разметки.

Что преобразуется чисто

Заголовки, абзацы, жирный шрифт и курсив, ссылки, изображения, встроенный код, блоки кода, цитаты, горизонтальные линии и оба вида списков, включая вложенные. Для них есть точные эквиваленты в Markdown, и результат выглядит так, как вы написали бы его вручную.

Что сохранить нельзя

В Markdown нельзя выразить оформление, классы, блоки div для вёрстки, span и вообще ничего визуального. Такие теги «разворачиваются»: их текст сохраняется, а сам тег отбрасывается, и количество таких случаев показывается, чтобы вы знали, что что-то было упрощено. Скрипты и блоки стилей удаляются полностью.

Таблицы

Текст таблиц сохраняется, но не превращается в таблицу Markdown, потому что в HTML-таблицах часто есть объединённые ячейки и вложенность, которые синтаксис таблиц Markdown действительно не способен передать. Простые таблицы быстрее заново оформить вручную, чем получить искалеченный результат.

Разбор, а не поиск по шаблону

HTML разбирается встроенным парсером вашего браузера, а не обрабатывается регулярными выражениями, поэтому некорректная и глубоко вложенная разметка обрабатывается так, как это сделал бы браузер.