HTML to Markdown

Конвертер обрабатывает заголовки (h1–h6), абзацы, жирный текст, курсив, зачёркивание, строчный код, ограждённые блоки кода, блочные цитаты, горизонтальные разделители, ссылки, изображения, нумерованные списки, маркированные списки, вложенные списки и таблицы — охватывая полный набор возможностей CommonMark и GitHub Flavored Markdown (GFM). Неизвестные структурные элементы — div, section, article — прозрачно передают своих дочерних элементов, не теряя контент. Большинство реального HTML — из экспорта CMS, скачанной статьи или страницы документации — конвертируется без необходимости дополнительной обработки.

Pandoc — мощный конвертер командной строки, но он требует установки, терминала и знания параметров запуска. Он подходит для автоматизированных серверных конвейеров, но избыточен для разовой конвертации. Turndown.js — наиболее используемая JavaScript-библиотека для конвертации HTML в Markdown: более 2,5 миллиона еженедельных загрузок через npm, свыше 10 800 звёзд на GitHub. Этот инструмент использует тот же DOM-подход парсинга, который делает Turndown надёжным. Отличие в том, что всё работает в браузере: без установки, командной строки, серверных запросов, и ни один файл не покидает устройство. Turndown требует настройки Node-проекта — этот инструмент не требует ничего.

Markdown — стандартный текстовый формат для технической документации и управления контентом. Конвертация HTML в Markdown позволяет импортировать контент в Notion или Obsidian, фиксировать его в Git-репозитории вместе с кодом, публиковать через генераторы статических сайтов — Astro, Hugo, Jekyll — или передавать в ИИ-модели и LLM. Исследования 2024 года показывают, что Markdown сокращает расход токенов на 68–87% по сравнению с сырым HTML при использовании с большими языковыми моделями — это реальная разница в стоимости и точности при построении RAG-конвейеров или подготовке датасетов для дообучения.

Да — миграция CMS является одним из наиболее распространённых профессиональных сценариев использования. Вставьте HTML, экспортированный из WordPress, Confluence, SharePoint, Ghost или любой другой платформы, и получите чистый Markdown для импорта в новую систему. Экспорт WordPress даёт HTML-блоки контента; Confluence экспортирует страницы как HTML или XHTML — оба формата конвертируются без проблем. Для лучших результатов вставляйте только основное тело контента, а не полный HTML страницы с навигацией и подвалом. Команды использовали браузерную конвертацию HTML в Markdown для переноса документации объёмом 150–200 страниц менее чем за два дня, не обращаясь к командной строке.

Таблицы конвертируются в формат pipe-таблиц GitHub Flavored Markdown (GFM) со строкой-разделителем из дефисов после строки заголовка. Этот формат работает в GitHub, GitLab, предпросмотре VS Code, Notion, Obsidian, Docusaurus и практически во всех современных движках Markdown. Вложенные таблицы сводятся в плоскую структуру, поскольку стандартный Markdown не поддерживает их нативно. Выравнивание столбцов — левое, по центру, правое через атрибут align или CSS text-align — сохраняется с помощью расположения двоеточий в строке-разделителе (например: :--- для левого, :---: для центра, ---: для правого).

Да. Конвертация происходит полностью в браузере с использованием встроенного DOM-парсера — файлы не загружаются, интернет-соединение не требуется после загрузки страницы. Это делает инструмент безопасным для работы с конфиденциальным HTML: внутренней документацией, проприетарными справочниками API или клиентскими материалами, которые не должны покидать устройство. Проверить это просто: откройте DevTools браузера, перейдите на вкладку Network и убедитесь, что при вставке HTML и запуске конвертации не отправляется ни один сетевой запрос. Ничего не уходит с вашего устройства.

Она удаляет конечные пробелы и табуляции из каждой строки Markdown-вывода, а также сворачивает несколько последовательных пустых строк в одну. Это сохраняет файлы в чистоте и предотвращает появление невидимых пробелов, которые могут повлиять на отображение в строгих парсерах Markdown — особенно в GitHub, который выделяет конечные пробелы как проблему линтера. Опция также облегчает использование вывода в документационных инструментах с проверкой пробелов. В подавляющем большинстве случаев её можно оставить включённой. Только в редких ситуациях конечные пробелы несут смысловую нагрузку.

Да. Вложенные элементы ul и ol обрабатываются рекурсивно, и каждый уровень корректно отступает в Markdown-выводе. Смешанная вложенность — нумерованные списки внутри маркированных и наоборот — также обрабатывается правильно. Трёхуровневый маркированный список внутри нумерованного, например, получает правильный четырёхпробельный отступ на каждом уровне — это стандарт CommonMark. Именно здесь конвертеры на основе регулярных выражений часто дают сбои и создают сломанный Markdown. DOM-парсинг справляется с этим надёжно.

Вывод следует CommonMark с расширениями GitHub Flavored Markdown (GFM) для таблиц и зачёркивания. CommonMark — стандартизированная спецификация, используемая большинством платформ; GFM добавляет синтаксис pipe-таблиц и зачёркивание ~~, поддерживаемые GitHub, GitLab и VS Code. Это обеспечивает совместимость с GitHub, GitLab, предпросмотром VS Code, Notion, Obsidian, Docusaurus, MkDocs и большинством современных движков Markdown. Если нужен строгий CommonMark без расширений GFM, единственным отличающимся элементом будут таблицы — всё остальное идентично.

Можно вставить любой HTML-фрагмент или полное тело страницы. Для лучших результатов рекомендуется вставлять только основную область контента — без полного документа с навигацией, боковой панелью и подвалом — чтобы вывод был сосредоточен на значимом содержимом. Большинство разработчиков копируют только div с статьёй или документацией из панели Elements в DevTools браузера (правая кнопка мыши → Копировать → Скопировать outerHTML). Это даёт чистый HTML контента без структурного обрамления страницы. Инструмент обрабатывает и полный HTML страницы, но вывод будет включать текст навигации в виде плоского списка ссылок, что обычно нежелательно.

ИИ-системы вроде Perplexity, ChatGPT и Gemini теперь читают, разбивают на фрагменты и используют веб-контент для генерации ответов. Markdown — их предпочтительный входной формат, поскольку он убирает HTML-теги структуры, которые расходуют токены, не добавляя смысловой ценности. Абзац в теге <p class="article-body"> стоит больше токенов, чем тот же абзац в чистом Markdown. Исследования 2024 года показывают, что Markdown сокращает расход токенов на 68–87% по сравнению с сырым HTML при том же содержимом — это напрямую снижает стоимость API и улучшает соотношение сигнал/шум для конвейеров RAG.

Строчные элементы кода (теги code не внутри pre) оборачиваются в одиночные обратные кавычки. Блоки кода (элементы pre > code) оборачиваются в ограждённые блоки с тройными обратными кавычками — стандарт CommonMark и GFM. Если элемент code имеет класс вроде 'language-python' или 'lang-python', идентификатор языка извлекается и сохраняется в открывающем ограждении для подсветки синтаксиса. Блоки кода, конвертированные со страниц README на GitHub или из документации, сохраняют языковые теги в выводе — подсветка синтаксиса из HTML переходит в Markdown.

Markdownify и h2m — npm-пакеты для Node.js, предназначенные для программной конвертации HTML в Markdown в рамках конвейера сборки. Они подходят для автоматизации конвертации сотен файлов в скрипте. Этот браузерный инструмент покрывает сценарий, который они не закрывают: быстрые разовые конвертации, контент, который нельзя отправлять на сервер, и ситуации, когда нет желания настраивать Node-проект. Качество конвертации сопоставимо — все три инструмента используют DOM-парсинг вместо регулярных выражений — но этот инструмент добавляет предпросмотр в реальном времени, кнопку копирования и счётчики символов и слов, что делает его практичнее для работы с контентом.

Да, конвертер полностью работает в мобильных браузерах. Вставьте HTML из буфера обмена, запустите конвертацию и скопируйте результат в Markdown — всё это с телефона или планшета. Интерфейс адаптируется к небольшим экранам с вертикальным расположением панелей. Проверено в Safari для iOS 17 и Chrome для Android 14. Один из распространённых мобильных сценариев: взять HTML статьи через меню «Поделиться» в браузере, конвертировать и вставить Markdown напрямую в Obsidian или Notion на том же устройстве, не прибегая к компьютеру. Без регистрации, без установки приложения, без ограничений.

HTML-комментарии (<!-- ... -->) удаляются из вывода, поскольку в Markdown нет синтаксиса комментариев, а сами комментарии редко являются частью реального контента. Теги script и их содержимое также отбрасываются — JavaScript не имеет смысла в Markdown. Теги style и строчные атрибуты style тоже удаляются: стилизация CSS не переводится в Markdown, а семантическое значение (жирный, курсив, заголовок) сохраняется через тип элемента, а не визуальный стиль. Если span выделен жирным через CSS, а не через тег strong или b, это форматирование не перенесётся — что является корректным поведением для конвертации формата содержимого.

Нет. Сервер не используется, поэтому нет ограничений по размеру, кроме возможностей памяти браузера. На практике браузерный DOM-парсер без проблем обрабатывает несколько мегабайт HTML — значительно больше любой реальной страницы CMS. При конвертации очень большого HTML-файла (полный экспорт книги, очень длинная скачанная статья) для получения наиболее чёткого вывода рекомендуется вставлять его по частям. Сама конвертация занимает миллисекунды вне зависимости от объёма, поскольку выполняется непосредственно в JavaScript в вашей вкладке браузера.