Как пользоваться: HTML в Markdown
- Вставьте HTML-код в левую панель или скопируйте отформатированный текст с веб-страницы или документа и вставьте его. Если включен параметр «Вставлять форматированный текст как HTML», форматирование сохранится.
- Выберите нужный стиль Markdown: тип заголовков, маркер списка, стиль блоков кода и встроенные или ссылки-ссылки.
- Оставьте включенным GFM, чтобы преобразовать
<table>,<del>и списки с флажками в Markdown с расширениями GitHub. - Скопируйте результат или скачайте его как файл
.md.
Что такое конвертер HTML в Markdown?
Конвертер HTML в Markdown читает HTML-элементы и переписывает их синтаксисом Markdown: <h2> превращается в ## , <strong> в **…**, а <a href> в [текст](url). Это самый быстрый способ перенести контент из CMS, старого блога или веб-страницы в Git-репозиторий, генератор статических сайтов (Hugo, Jekyll, Astro, Docusaurus), вики или приложение для заметок вроде Obsidian. Инструмент использует библиотеку с открытым исходным кодом Turndown с плагином GFM и работает полностью в вашем браузере.
Копирование с веб-страниц, Google Docs и Word
Когда вы копируете текст из браузера или офисного приложения, в буфере обмена сохраняется HTML-версия вместе с обычным текстом. Если включена опция Вставлять форматированный текст как HTML, вставка в левую панель добавит этот HTML, и заголовки, полужирный текст, ссылки и списки сохранятся. Отключите опцию, если нужно вставить исходный HTML-код ровно так, как он был скопирован из редактора кода.
Пример
<h2>Install</h2>
<p>Run <code>npm i</code>, then
read the <a href="/docs">docs</a>.</p>
<ul>
<li>Fast</li>
<li><em>Small</em></li>
</ul>
превращается в
## Install
Run `npm i`, then read the [docs](/docs).
- Fast
- _Small_
Turndown выравнивает маркеры списков по отступу в четыре символа, поэтому вложенные списки и элементы из нескольких абзацев корректно отображаются в любом парсере Markdown.
Описание параметров
| Параметр | Варианты | Когда использовать |
|---|---|---|
| Заголовки | # ATX или Setext (подчеркивание ===/---) | ATX — распространенный вариант по умолчанию; Setext существует только для h1 и h2. |
| Маркер списка | -, *, + | Выбирайте по правилам линтера вашего проекта (правило markdownlint MD004). |
| Блоки кода | Ограждения ```, ограждения ~~~, отступ в 4 пробела | Ограждения сохраняют язык (из class="language-js"), а блоки с отступом — нет. |
| Ссылки | Встроенные или ссылки-ссылки | Ссылки-ссылки выносят длинные URL из абзацев и собирают их в конце документа. |
Что не конвертируется
В Markdown нет синтаксиса для цветов, шрифтов, колоночной верстки, форм и объединенных ячеек таблиц. Стили отбрасываются, блоки <script> и <style> удаляются, а таблицы без строки заголовков сохраняются как HTML, так как таблицы GFM требуют заголовка и поддерживают только простые однострочные ячейки. Объединенные ячейки (colspan/rowspan) передать нельзя. Сначала очистите неаккуратную разметку с помощью HTML-форматтера, а результат проверьте в конвертере Markdown в HTML.
Также ищут как: конвертер html в md, html to md, rich text в markdown, веб-страница в markdown, html2markdown, таблица gfm.
Инструменты, которые хорошо сочетаются с HTML в Markdown
- HTML в Webflow Rich Text — Вставьте «грязный» HTML со старого сайта, экспорта из WordPress, Google Docs или Word и получите чистую семантическую разметку, которую элемент Rich Text в Webflow и импорт CMS принимают без лишнего мусора.
- HTML-сущности — Экранируйте < > & ", чтобы текст безопасно отображался в HTML, преобразуйте акценты и символы в именованные или числовые сущности либо декодируйте HTML с сущностями обратно в обычный текст.
- Сравнение текстов — Вставьте исходную и изменённую версии, чтобы увидеть добавленные, удалённые и изменённые строки рядом — с подсветкой точно изменённых слов внутри каждой строки.
- Счётчик слов — Вставьте или напишите текст, чтобы сразу увидеть количество слов и символов, а также время чтения и произнесения, плотность ключевых слов и проверку длины для SEO-заголовков, мета-описаний и постов в соцсетях.
Часто задаваемые вопросы
Можно ли вставить результат в Webflow?
Отправляется ли мой HTML на сервер?
Как конвертировать всю веб-страницу в Markdown?
Почему моя таблица осталась HTML?
<th> или <thead>) сохраняются как HTML, который поддерживает большинство рендереров Markdown. Объединенные ячейки, вложенные таблицы и списки внутри ячеек в GFM выразить невозможно.Какой маркер списка выбрать?
- — самый распространенный выбор и вариант по умолчанию в Prettier. Выбирайте тот, который требуется в гайде по стилю вашего проекта или в конфигурации markdownlint.Изображения конвертируются?
<img src="a.png" alt="Logo"> превращается в , включая атрибут title, если он есть. Сами файлы изображений не скачиваются.