TanodTools
RU

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

Вставьте HTML или откройте файл .html и получите аккуратный Markdown для README, вики или приложения для заметок.

Работает полностью в браузере

Машинный перевод; не проверено носителем языка. Machine-translated; not reviewed by a native speaker.

Вставьте HTML, чтобы начать.

Для файлов Word, Excel, PowerPoint и EPUB платный API Document to Markdown возвращает фрагменты в том же формате: POST https://tanod.dev/v1/docs/to-markdown с "chunks": "headings".

HTML до 5 МБ, вставленный или из файла .html. Результат обновляется по мере ввода.

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

  1. Вставьте HTML в поле или откройте файл .html.
  2. Выберите нужный стиль заголовков, списков и блоков кода. Таблицы превращаются в таблицы Markdown, если вы не отключите это.
  3. Скопируйте Markdown, скачайте его файлом .md или скачайте файлом .jsonl, разбитым на фрагменты по заголовкам.

Как превратить веб-страницу в Markdown

Чтобы перенести содержимое веб-страницы, старой CMS или визуального редактора в README, статический сайт или приложение для заметок, обычно нужно преобразовать HTML в Markdown. Конвертер обходит структуру HTML и записывает каждый элемент в форме Markdown: заголовки становятся строками с #, списки — строками с дефисами, ссылки — записью [текст](url), а <pre><code> — блоком кода.

Markdown описывает только структуру, поэтому оформление теряется. Встроенные стили, классы, цвета и контейнеры вёрстки исчезают, а слова, выделение, ссылки, изображения и списки остаются. Если таблица достаточно проста, она записывается как таблица в формате GitHub Flavored Markdown.

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

Скачивание фрагментов разбивает Markdown по заголовкам, для поисковых индексов и систем поиска по документам. Каждая строка файла .jsonl содержит один фрагмент: путь заголовков, например ["Настройка", "Установка"], текст, его длину в символах, оценку числа токенов (число символов, делённое на 4, с округлением вверх), хеш SHA-256 текста (Unicode NFC, без пробелов в конце строк) и id якоря, если он есть у заголовка или его раздела. Фрагмент содержит не более 1500 символов. Более длинные разделы делятся между абзацами, затем между строками. Ограждённый блок кода (```) никогда не делится, а длинная таблица делится между её строками, и шапка таблицы повторяется. Текст до первого заголовка получает пустой путь.

Советы

  • Посмотреть, как отображается Markdown, можно в инструменте «Markdown в HTML» с предпросмотром.
  • Убрать лишние пробелы и поправить формулировки поможет «Поиск и замена».
  • Посчитайте слова в результате с помощью «Подсчёт слов».

Вопросы и ответы

Мой HTML загружается на сервер?

Нет. Он преобразуется в вашем браузере с помощью библиотеки Turndown с открытым исходным кодом, ничего никуда не отправляется и не сохраняется.

Загружаются ли изображения и выполняются ли скрипты из HTML?

Нет. HTML читается в отдельный документ, который браузер никогда не показывает, поэтому скрипты не выполняются, а изображения, шрифты и таблицы стилей не загружаются. Блоки script и style в результат не попадают.

Как преобразуются таблицы?

Простые таблицы становятся таблицами Markdown в стиле GitHub: первая строка служит заголовком, а выравнивание по левому краю, по центру или по правому сохраняется, если оно задано в HTML. Таблицы с объединёнными ячейками (rowspan или colspan) и таблицы внутри таблиц нельзя записать в виде таблиц Markdown, поэтому они остаются в виде HTML, который большинство средств отображения Markdown показывают как есть. Преобразование таблиц можно отключить, чтобы все таблицы остались HTML.

Чем отличаются стили заголовков и кода?

Заголовки ATX начинаются со знаков # (# Заголовок) и подходят для любого уровня; заголовки Setext подчёркиваются знаками = или - и существуют только для уровней 1 и 2, поэтому более глубокие заголовки всё равно используют #. Ограждённые блоки кода заключают код в тройные обратные кавычки и сохраняют название языка из класса language-; блоки с отступом используют четыре пробела — это более старый стиль.

Что теряется при преобразовании?

В Markdown нельзя выразить цвета, шрифты, классы, вёрстку и элементы форм, поэтому они отбрасываются, и остаются только текст и его структура. Зачёркивание превращается в ~~текст~~, а флажки в элементах списка — в маркеры списка задач. Символы, которые иначе были бы восприняты как разметка Markdown, например # или * в начале строки, экранируются обратной косой чертой.