Конвертер HTML в Markdown

Что такое конвертация HTML в Markdown?

HTML in:

  <h2>Pricing</h2>
  <p>Plans start at <strong>$9/mo</strong>. See the <a href="https://example.com/pricing">details</a>.</p>
  <table>
    <thead><tr><th>Plan</th><th>Price</th></tr></thead>
    <tbody><tr><td>Pro</td><td>$9</td></tr></tbody>
  </table>

Markdown out:

  ## Pricing

  Plans start at **$9/mo**. See the [details](https://example.com/pricing).

  | Plan | Price |
  | ---- | ----- |
  | Pro  | $9    |

  <!-- <div>, classes, and inline styles in the source are dropped — Markdown can't represent them. -->

Ключевые возможности

Примеры

<table>
  <thead><tr><th>Region</th><th>Sales</th></tr></thead>
  <tbody>
    <tr><td>EMEA</td><td>1,204</td></tr>
    <tr><td>APAC</td><td>980</td></tr>
  </tbody>
</table>

| Region | Sales |
| ------ | ----- |
| EMEA   | 1,204 |
| APAC   | 980   |

<p>Read the <a href="https://example.com/guide">setup guide</a> and the <a href="https://example.com/api">API reference</a>.</p>

Inline:
Read the [setup guide](https://example.com/guide) and the [API reference](https://example.com/api).

Reference:
Read the [setup guide][1] and the [API reference][2].

[1]: https://example.com/guide
[2]: https://example.com/api

<ul>
  <li>Build
    <ol>
      <li>Compile</li>
      <li>Bundle</li>
    </ol>
  </li>
  <li>Ship</li>
</ul>

- Build
  1. Compile
  2. Bundle
- Ship

<article>
  <h1>Changelog</h1>
  <p>We shipped <strong>dark mode</strong> and fixed <code>parseDate()</code>.</p>
  <blockquote><p>Thanks to everyone who reported it.</p></blockquote>
</article>

# Changelog

We shipped **dark mode** and fixed `parseDate()`.

> Thanks to everyone who reported it.

Как преобразовать HTML в Markdown

1. 1

   Вставьте ваш HTML

   Поместите скопированную веб-страницу, экспорт CMS или WYSIWYG либо скрейпленный HTML-фрагмент. DOM разбирается и сериализуется в Markdown в браузере по мере вставки — без загрузки, без лимита размера сверх памяти браузера.

2. 2

   Выберите стиль заголовков и ссылок

   Выберите ATX (#) или Setext (===) заголовки и inline или reference ссылки. Markdown перерисовывается вживую, поэтому стили можно сравнить мгновенно. Вывод нацелен на GitHub Flavored Markdown — таблицы, списки задач и зачёркивание включены.

3. 3

   Скопируйте или скачайте

   Нажмите «Скопировать», чтобы взять Markdown, или «Скачать», чтобы сохранить файл .md. Чтобы пойти в обратную сторону, переключитесь на вкладку Markdown → HTML и вставьте ваш Markdown, чтобы получить отрисованный HTML обратно.

Частые ошибки

<div class="callout warning"><span style="color:red">Heads up!</span></div>
<!-- expecting the callout box and red colour to survive -->

Heads up!
<!-- container and styles dropped; only the text remains in Markdown -->

Line one<br>Line two
<!-- if the break form is removed, these merge into one line -->

Line one  
Line two
<!-- two trailing spaces preserve the <br> as a hard break -->

<table><tr><td><table><tr><td>inner</td></tr></table></td></tr></table>
<!-- nested table can't become a flat pipe table -->

<!-- Flatten to a single-level table first: -->
<table><tr><td>inner</td></tr></table>
→ | inner |
  | ----- |

<style>.x{color:blue}</style>
<script>track()</script>
<p>Body</p>
<!-- expecting the style and script to come through -->

Body
<!-- only the content survives; <script>/<style> are dropped -->

Типичные сценарии

Перенос веб- или CMS-контента в Notion, Obsidian или статический сайт

Вытяните страницы из CMS, экспорта WordPress или старого HTML-сайта и конвертируйте их в Markdown, который ложится прямо в Notion, Obsidian, Hugo или Jekyll. Вы меняете многословную разметку на переносимый текст, который чисто живёт в Git-репозитории и разумно диффится при ревью.

Экспорт из WYSIWYG-редактора

Rich-text редакторы выдают плотный, насыщенный атрибутами HTML. Вставьте этот вывод сюда, чтобы восстановить чистый Markdown под ним — заголовки, списки, ссылки и выделение — чтобы контент мог перейти в пайплайн документации или Markdown-базу знаний, а не остаться запертым в редакторе.

Очистка HTML в Markdown для подачи в LLM и RAG-пайплайны

Сырой HTML сжигает токены на теги, скрипты и стилизацию, которые модели никогда не нужны. Конвертация скрейпленной страницы в Markdown убирает этот шум, сохраняя структуру, которую LLM читает хорошо, поэтому вы помещаете больше реального контента в контекстное окно и получаете более чистые эмбеддинги для поиска.

Превратить rich-text вставку в Markdown

Скопируйте форматированный текст с веб-страницы, из письма или документа, и он попадает в буфер обмена как HTML. Вставьте его сюда, чтобы превратить этот rich text в Markdown, который можно закоммитить, отправить в pull request или записать в заметки — форматирование сохранено, мусор убран.

Архивировать страницу как Markdown

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

Превратить легаси HTML-документацию в Markdown

Старую документацию, написанную как HTML вручную, больно поддерживать. Конвертируйте её в Markdown, чтобы привести в современный процесс docs-as-code — где её можно линтить, ревьюить в pull request и отрисовывать генератором статического сайта.

Технические детали

Вывод CommonMark vs GitHub Flavored Markdown

Конвертер может нацеливаться на обычный CommonMark или, по умолчанию, на надмножество GitHub Flavored Markdown. CommonMark точно определяет заголовки, выделение, списки, ссылки, изображения, код и цитаты. GFM добавляет четыре конструкции, которые прямо отображаются из распространённого HTML: <table> → пайповая таблица, элементы списка с чекбоксами → списки задач, <del>/<s> → зачёркивание, голые URL → автоссылки. Поскольку большинство веб-контента использует таблицы и подобное, вывод GFM — практичный дефолт; выбирайте CommonMark только когда рендерер назначения не понимает расширения GFM, и тогда таблицы откатываются к сырому HTML.

Конвертация с потерями и необратимая — прямо заявлено

HTML строго выразительнее Markdown, поэтому конвертация не может быть без потерь, и об этом стоит говорить прямо. В Markdown нет синтаксиса для <div>, <span> или других обобщённых контейнеров; нет способа нести имена классов, id, inline-стиль, colspan/rowspan или произвольные атрибуты data-*; и нет представления для большинства семантических или верстальных элементов. Они разворачиваются (содержимое сохраняется, тег отбрасывается), отбрасываются (атрибуты) или — когда отбрасывание потеряло бы смысл — сохраняются как сырой встроенный HTML. Круговой проход HTML → Markdown → HTML не воспроизведёт оригинал. Это намеренный компромисс: Markdown существует, чтобы быть чистым, диффящимся и редактируемым человеком, а не зеркалить HTML. Большинство конкурентов это замалчивают; заявление этого позволяет вам решить с открытыми глазами, правильная ли Markdown цель.

Компромиссы стиля: ATX/Setext, Inline/Reference, Огороженный/С отступами

Три выбора вывода несут реальные компромиссы. ATX-заголовки (#) покрывают все шесть уровней и чисто грепаются; Setext (подчёркнутый) существует только для H1/H2, поэтому инструмент выдаёт его для двух верхних уровней и откатывается к ATX ниже. Inline-ссылки держат URL рядом с текстом — лучше для редких ссылок; reference-ссылки уводят URL в подвал документа — лучше для насыщенной ссылками прозы и переиспользования по метке. Для кода огороженные блоки (тройные обратные кавычки) несут информационную строку языка и безопасно вкладываются, тогда как блоки с отступом (четыре пробела) не могут выразить язык и ломаются внутри списков — поэтому этот конвертер всегда выдаёт огороженные блоки из <pre><code>.

Лучшие практики

Отформатируйте HTML перед конвертацией

Минифицированный или глубоко запутанный HTML — особенно вложенные верстальные таблицы и случайные встроенные элементы — конвертируется чище, когда он сначала корректно сформирован. Прогоните неаккуратный исходник через наш HTML-форматтер, чтобы отформатировать и нормализовать его, затем конвертируйте. Чистый ввод даёт чистый Markdown с меньшим числом откатов к сырому HTML.

Ожидайте и проверяйте потери

Относитесь к конвертации как к намеренно потерянной. Классы, inline-стили, обёртки <div>/<span> и экзотические атрибуты исчезают в выводе, и обычно это то, что вам нужно для переносимого Markdown — но просмотрите результат на предмет чего-то семантически важного, что жило только в атрибуте (aria-label, объединённая через colspan ячейка), и добавьте обратно вручную, если это важно.

Выбирайте стиль ссылок под плотность документа

Используйте inline-ссылки для прозы со ссылкой тут и там — URL остаётся рядом со своим текстом и исходник читается естественно. Переключайтесь на reference-ссылки, когда раздел насыщен ссылками или переиспользует одни и те же URL: увод их в нумерованный список в подвале сохраняет абзацы сканируемыми и избегает повтора длинных URL.

Конвертируйте в Markdown перед отправкой страниц в LLM

Когда вы подаёте веб-контент модели — для промпта, эмбеддинга или RAG-хранилища — сначала конвертируйте HTML в Markdown. Вы убираете теги, скрипты и стилизацию, которые тратят токены и добавляют шум, сохраняете структуру, которую модель действительно использует, и помещаете существенно больше реального контента в контекстное окно.

Проверяйте сложные таблицы после конвертации

GFM пайповые таблицы плоские — нет вложенных таблиц, нет блочного содержимого в ячейках, нет объединённых ячеек. После конвертации насыщенной данными или верстальной таблицы проверьте Markdown: простые сетки конвертируются идеально, но всё с colspan или вложенными блоками деградирует и может оказаться сырым HTML. Сначала упростите исходную таблицу, если чистая пайповая таблица важна.

Часто задаваемые вопросы