Что делает инструмент
Конвертер HTML в Markdown превращает HTML-разметку в чистый и читаемый Markdown. С его помощью можно перенести статьи блога из CMS в генератор статических сайтов, написать README по существующим страницам, сохранить документацию в заметки или подготовить текст для вики, задачи на GitHub или чата с поддержкой Markdown.
Результат следует распространённым соглашениям Markdown: заголовки #, пункты списка -, ограждённые блоки кода с исходным языком, а также таблицы и зачёркивание GitHub Flavored Markdown. Текст при необходимости экранируется, чтобы ничего случайно не стало форматированием.
Как пользоваться
- Вставьте HTML в поле ввода, загрузите файл
.htmlили нажмите Пример. - Настройте стиль, если в проекте есть свои правила: маркер списка, ограждённые блоки кода или с отступом, знаки курсива и жирного, встроенные ссылки или сноски.
- Скопируйте Markdown или скачайте его как файл
.md.
Пример
Этот 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>
превращается в такой Markdown:
## Install
Run the **installer** and read the [guide](https://example.com).
- Windows
- macOS
Советы
- Копируете из браузера? Возьмите через исходный код страницы или инструменты разработчика только HTML элемента статьи, чтобы меню и подвал не попали в результат.
- Ссылки-сноски убирают длинные URL из текста, и Markdown легче читать и редактировать. Адреса перечисляются в конце.
- Встроенные изображения
data:по умолчанию удаляются, потому что могут занимать сотни килобайт. Включите опцию, чтобы их сохранить. - Для обратного преобразования используйте конвертер Markdown в HTML или посмотрите результат в предпросмотре Markdown.
Частые вопросы
› Какие элементы HTML преобразуются?
Заголовки, абзацы, жирный, курсив, зачёркнутый текст, ссылки, изображения, нумерованные и маркированные списки (включая вложенные), цитаты, встроенный код, блоки кода с языком, горизонтальные линии, переносы строк и таблицы. Таблицы становятся таблицами GitHub Flavored Markdown.
› Что происходит со скриптами, стилями и head страницы?
Они удаляются. Script, style, noscript, template, svg, iframe и весь раздел head не дают Markdown, поэтому можно вставить исходный код целой страницы и получить только читаемое содержимое.
› А как быть с HTML, который Markdown не может выразить?
Неизвестные теги снимаются, их текст сохраняется. Атрибуты вроде классов, встроенных стилей и ID отбрасываются, потому что в Markdown для них нет синтаксиса. Блок кода сохраняет язык, если у элемента code есть класс вроде language-js.
› Почему некоторые символы экранированы обратной косой чертой?
Текст, который иначе превратился бы в форматирование Markdown, например строка, начинающаяся с 1., или слова в звёздочках, экранируется, чтобы Markdown отображался точно как исходный текст HTML.
› HTML загружается на сервер?
Нет. Преобразование выполняется в браузере с помощью HTML-парсера на JavaScript, и ничего не отправляется на сервер.