Извлеките структуру документа, а не копируйте оформление страницы
Используйте сохраненный или скопированный HTML, чтобы создать читаемый черновик документации или материала для репозитория. Конвертер сохраняет заголовки, ссылки, списки и простые таблицы, удаляя скрипты и стили страницы. Перед сохранением можно проверить получившийся Markdown.
Это преобразование HTML в Markdown, а не сбор данных с веб-страниц. Вставьте исходный код или откройте HTML-файл. URL страницы, снимок экрана и PDF — другие типы входных данных: инструмент не загружает и не анализирует их.
Что сохраняется при преобразовании HTML
Основные элементы документа
Заголовки, выделение, ссылки, списки, цитаты и простые блоки кода преобразуются в соответствующий синтаксис Markdown.
Таблицы становятся редактируемым исходником
Простые таблицы HTML превращаются в таблицы GFM с вертикальными чертами. Проверьте заголовки и ячейки, которые изначально занимали несколько строк или столбцов.
Проверьте текст и результат отображения
Переключайтесь между исходником Markdown и предпросмотром. Результат — исходный текст; предпросмотр помогает заметить пропущенные уровни заголовков и неожиданные переносы строк.
Локальный процесс конвертации
Откройте HTML/текстовый файл или вставьте исходник, а затем скопируйте или скачайте Markdown. Загружать данные для преобразования не нужно.
Начните с документа, который вам действительно нужен
Фрагмент статьи в HTML
Перенесите содержимое статьи в черновик документации или репозитория.
<h2>Список проверки</h2> <p>Перед публикацией проверьте <strong>исходник</strong>.</p> <ul><li>Проверьте утверждения</li><li>Проверьте ссылки</li></ul>
- Уровень заголовка сохранен.
- Выделенный текст остается читаемым.
- Пункты списка разделены.
Небольшая таблица HTML
Преобразуйте обычные ячейки в редактируемую таблицу Markdown.
<table> <thead><tr><th>Формат</th><th>Назначение</th></tr></thead> <tbody><tr><td>HTML</td><td>Материалы для интернета</td></tr><tr><td>Markdown</td><td>Редактируемый исходник</td></tr></tbody> </table>
- Сформирована настоящая строка заголовка.
- Не предполагается наличие объединенных ячеек.
- Текст ячеек не потерян.
Практический порядок работы
Используйте исходный HTML-код
Вставьте разметку или откройте файл .html/.htm. Не ожидайте загрузки сайта при вводе URL и не считайте, что копирование отображаемой страницы всегда включает исходный код.
Проверьте, что упростилось
Проверьте уровни заголовков, вложенные списки и шапки таблиц. Контейнеры верстки и CSS-оформление в результат Markdown не входят.
Завершите черновик
Скопируйте Markdown или скачайте MD. Чтобы изменить структуру таблицы, скорректировать блоки кода или добавить пояснения, продолжите работу в редакторе Markdown.
Проверьте результат перед отправкой
| Содержание | Что сделать | Что ожидать |
|---|---|---|
| Объединенные ячейки | Вручную проверьте содержимое ячеек с rowspan и colspan. | Обычные таблицы Markdown не поддерживают все варианты разметки HTML-таблиц. |
| Изображения | Оставьте полные действующие URL изображений или позже встроите локальные файлы. | Относительные пути теряют контекст исходной веб-страницы и требуют изменений. |
| Код и переносы строк | Проверьте созданные блоки кода и границы абзацев. | Разметка, основанная на пробелах, может потребовать ручной корректировки. |
| Встроенные скрипты и формы | Убедитесь, что результат содержит только нужный текст документа. | Интерактивное поведение веб-страницы намеренно удаляется. |
Вопросы о рабочем процессе
Как преобразовать HTML в Markdown?
Вставьте исходный HTML или откройте сохраненный файл .html. Проверьте предпросмотр, переключитесь на Markdown, чтобы посмотреть созданный синтаксис, затем скопируйте его или скачайте .md для дальнейшего редактирования.
Можно ли преобразовать HTML-таблицу в Markdown?
Да, если таблица имеет обычную структуру. Таблицы GFM с вертикальными чертами не полностью представляют объединенные ячейки, вложенные макеты и все стили отдельных ячеек — такие случаи нужно проверить вручную.
Можно ввести URL сайта?
Эта страница не загружает сайты. Скопируйте нужный HTML-код или сохраните HTML-файл и откройте его. Для динамического содержимого страницы может потребоваться отдельный способ извлечения.
Сохранятся ли шрифты, цвета и макет?
Markdown описывает структуру документа, а не произвольное оформление страницы. Скрипты, формы, собственный CSS и интерактивные элементы удаляются.
Почему изображение перестало работать?
Возможно, у изображения относительный путь или оно зависит от исходного сайта. Замените его полным действующим URL или добавьте локальное изображение в редакторе Markdown.
Мой HTML загружается на сервер?
Преобразование HTML в Markdown, предпросмотр и скачивание MD выполняются в браузере. При включении внешних изображений отправляются запросы к хосту изображения.
Как инструмент обрабатывает документ
- Перед локальным преобразованием исходный HTML очищается.
- Результат содержит текст документа, а не исполняемую копию веб-страницы.
- Редактор назначения может по-разному интерпретировать расширения Markdown; сначала проверьте небольшой пример.
Справочные материалы о форматахПроект TurndownТаблицы GitHub Flavored Markdown
Сообщите о воспроизводимой проблемеУкажите браузер, выбранные настройки и небольшой пример без конфиденциальной информации. Не отправляйте личные документы по электронной почте.
