Як конвертувати 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-файлу, яким можна поділитися.