Как конвертировать HTML в Markdown
- Вставьте фрагмент HTML или загрузите поддерживаемый файл
.html. - Сконвертируйте исходный код и проверьте, какие семантические элементы сохраняют свое значение в Markdown.
- Преобразуйте и проверьте ссылки, изображения, вложенные списки, таблицы и блоки кода.
- Скопируйте Markdown или скачайте файл
.md.
Что сохраняет конвертер?
| Исходный контент | Рекомендуемое поведение на выходе | Примечание к конвертации |
|---|---|---|
| Заголовки | Сопоставлять <h1>–<h6> с заголовками Markdown | |
| Абзацы и выделение текста | Конвертировать абзацы, жирный текст и курсив | |
| Списки | Конвертировать упорядоченные, неупорядоченные и вложенные списки | |
| Ссылки | Сохранять текст и разрешенный URL-адрес | |
| Изображения | Сохранять источник и альтернативный текст | |
| Код | Использовать встроенный код и выделенные блоки кода | |
| Таблицы | Конвертировать совместимые таблицы в GFM | |
| Цитаты | Конвертировать семантические блоки цитат |
Распространенное использование HTML в Markdown
Перенос веб-документации
Переместите семантический HTML в систему документации на основе Markdown.
Очистить скопированный форматированный текст
Преобразуйте созданный редактором HTML в более простой формат перед созданием версий или публикацией.
Подготовьте примеры кода
Сохраняйте блоки кода и заголовки, не перенося при этом полную таблицу стилей страницы.
Создайте текстовый контекст ИИ
Удалите сценарии и стили, сохранив при этом информационную структуру, которую еще необходимо просмотреть.
Скрытый и шаблонный контент
Конвертеру необходимы четкие правила в отношении скрытых элементов, навигации и визуально свернутого контента.
Распространенное использование HTML в Markdown
Перенос веб-документации
Переместите семантический HTML в систему документации на основе Markdown.
Очистить скопированный форматированный текст
Преобразуйте созданный редактором HTML в более простой формат перед созданием версий или публикацией.
Подготовьте примеры кода
Сохраняйте блоки кода и заголовки, не перенося при этом полную таблицу стилей страницы.
Создайте текстовый контекст ИИ
Удалите сценарии и стили, сохранив при этом информационную структуру, которую еще необходимо просмотреть.
Скрытый и шаблонный контент
Конвертеру необходимы четкие правила в отношении скрытых элементов, навигации и визуально свернутого контента.
Пример конвертации HTML в Markdown
<h2>Setup</h2>
<p>Read the <a href="/guide">guide</a>.</p>
<ul><li>Install</li><li>Test</li></ul>## Setup
Read the [guide](/guide).
- Install
- TestСоветы по получению более чистого Markdown
- Используйте семантический HTML Заголовки, списки и таблицы конвертируются более надежно, чем общие макетные контейнеры.
- Указывайте базовый URL-адрес при необходимости Относительные ссылки требуют контекста, если результат должен работать за пределами исходной страницы.
- Выберите диалект вывода GFM поддерживает таблицы и списки задач, которые не определены в базовом CommonMark.
- Проверяйте блоки кода Подтвердите обнаруженный язык программирования и любые встроенные обратные кавычки.
- Определите правила для необработанного HTML Сохранение неподдерживаемого HTML может сберечь информацию, но снижает переносимость.
Бесперебойная работа с файлами размером в несколько гигабайт
SolConverter создан для перемещения файлов размером в несколько гигабайт, не замораживая рабочее пространство. Он обрабатывает исходные данные управляемыми фрагментами, упрощает предварительный просмотр на экране и позволяет загружать готовый артефакт без загрузки всего результата сразу.
Загрузка, преобразование и предварительный просмотр остаются оперативными по мере увеличения размера файлов. Фоновая обработка и прогрессивные обновления берут на себя тяжелую работу, поэтому вы можете работать с исходными файлами размером в несколько ГБ, сохраняя при этом рабочее пространство браузера пригодным для использования.
Часто задаваемые вопросы
Удаляются ли элементы <script> и <style>?
Скрипты и стили не являются полезным контентом Markdown, и на них не следует полагаться в результате. Проверьте вставленный HTML перед повторным использованием вывода.
Конвертируются ли HTML-таблицы в таблицы Markdown?
Совместимые прямоугольные таблицы могут стать таблицами GFM. Таблицам с rowspan, colspan, вложенными блоками или несколькими строками заголовков требуется документированное резервное решение.
Сохраняются ли блоки кода и встроенный код?
Они могут быть сопоставлены из тегов <pre> и <code>.
Что происходит со ссылками и изображениями?
Допустимый текст ссылок и места назначения могут быть сохранены. Относительные ссылки и пути к изображениям остаются зависимыми от контекста, так как у загруженного фрагмента нет гарантированного базового URL-адреса.
Удаляются или сохраняются неподдерживаемые HTML-теги?
Исключительно оформительские контейнеры могут быть упрощены, в то время как читаемый текст сохраняется. Сравните вывод с источником, если пользовательские элементы несут смысл.
Выводит ли конвертер CommonMark или GFM?
Целевым форматом вывода является GitHub-Flavored Markdown. Таблицы, зачеркивание и списки задач используют расширения GFM.
Могу ли я вставить весь HTML-документ?
Да. Вы можете вставить фрагмент или загрузить файл .html или .htm, а затем просмотреть сгенерированный Markdown.
Может ли эта страница конвертировать URL-адрес живого веб-сайта?
Нет. Эта страница принимает вставленный HTML или загруженный HTML-файл; она не загружает данные по URL-адресу живого веб-сайта.
Конвертировать Markdown обратно в PDF
Уже есть файл Markdown? Используйтеконвертер Markdown в PDFдля создания PDF-файла, которым можно поделиться.