Как конвертировать HTML в Markdown
- Вставьте фрагмент HTML или загрузите поддерживаемый файл
.html. - Сконвертируйте исходный код и проверьте, какие семантические элементы сохраняют свое значение в Markdown.
- Преобразуйте и проверьте ссылки, изображения, вложенные списки, таблицы и блоки кода.
- Скопируйте Markdown или скачайте файл
.md.
Что сохраняет конвертер?
| Исходный контент | Рекомендуемое поведение на выходе | Примечание к конвертации |
|---|---|---|
| Заголовки | Сопоставлять <h1>–<h6> с заголовками Markdown | |
| Абзацы и выделение текста | Конвертировать абзацы, жирный текст и курсив | |
| Списки | Конвертировать упорядоченные, неупорядоченные и вложенные списки | |
| Ссылки | Сохранять текст и разрешенный URL-адрес | |
| Изображения | Сохранять источник и альтернативный текст | |
| Код | Использовать встроенный код и выделенные блоки кода | |
| Таблицы | Конвертировать совместимые таблицы в GFM | |
| Цитаты | Конвертировать семантические блоки цитат |
Что может измениться во время конвертации?
Скрипты, стили и формы
Исполняемые и интерактивные элементы не имеют обычного эквивалента в Markdown и могут быть опущены или преобразованы в обычный текст.
Сложные таблицы
Объединенные строки (rowspans), объединенные столбцы (colspans), вложенные таблицы и богатое содержимое ячеек могут потребовать необработанного HTML или упрощения структуры.
Относительные URL-адреса
Вставленный фрагмент может не содержать базовый URL-адрес страницы, поэтому относительные ссылки и пути к изображениям не всегда могут быть разрешены.
Макетные контейнеры
Макеты на основе div, grid и flexbox не подразумевают семантического порядка чтения.
Скрытый и шаблонный контент
Конвертеру необходимы четкие правила в отношении скрытых элементов, навигации и визуально свернутого контента.
Распространенные варианты использования 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 может сберечь информацию, но снижает переносимость.
Часто задаваемые вопросы
Удаляются ли элементы <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-файла, которым можно поделиться.