Конвертер 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
- Вставьте HTML в поле или откройте файл .html.
- Выберите нужный стиль заголовков, списков и блоков кода. Таблицы превращаются в таблицы Markdown, если вы не отключите это.
- Скопируйте 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, например # или * в начале строки, экранируются обратной косой чертой.