Как пользоваться
- Вставьте HTML в поле HTML. В примере есть заголовок, абзац с выделением и ссылкой, а также список.
- Читайте Markdown (CommonMark): он обновляется по мере ввода.
- Скопируйте его кнопкой копирования и сохраните как файл .md или вставьте в редактор Markdown.
Что преобразуется и как
Заголовки h1–h6 становятся заголовками ATX с от одного до шести знаков решётки. Элементы strong и b становятся жирным текстом, а em и i — *курсивным текстом*. Элемент code становится фрагментом кода, а pre — блоком кода с ограждением, и язык сохраняется, если у кода есть класс language-. Элемент br становится жёстким переносом строки, blockquote ставит > перед каждой строкой, а ul и ol становятся списками с - и с номерами. Элемент a с href становится ссылкой, а img с src — изображением с его альтернативным текстом (разделы 4.2, 4.5, 5.1, 5.2, 6.1, 6.2, 6.3 и 6.7 CommonMark).
Символ, который Markdown прочитал бы как разметку, экранируется обратной косой чертой: звёздочка, подчёркивание, знак обратной кавычки, квадратные скобки и угловая скобка, а также строка, которая начиналась бы как заголовок, цитата или список. Раздел 2.4 CommonMark разрешает обратную косую черту перед любым знаком пунктуации ASCII.
Что не сохраняется
Скрипты, стили, шаблоны, фреймы, элементы форм и медиа пропускаются вместе с содержимым. Атрибуты, кроме href, src, alt и title, отбрасываются. В CommonMark нет таблиц, подчёркивания и цвета, поэтому таблица становится абзацем для каждой ячейки, а текст элементов u, span и похожих сохраняется без оформления.
Три элемента и символ для экранирования
Каждый фрагмент HTML в таблице даёт Markdown в правом столбце, как его пишет инструмент.
| Что содержит HTML | Markdown |
|---|---|
| Заголовок второго уровня с текстом Заметки | ## Заметки |
| Абзац с жирным текстом | Немного **жирного** текста |
| Список из одного пункта: Первый | - Первый |
| Текст 5 * 3 = 15, со звёздочкой | 5 * 3 = 15 |
Частые вопросы
Почему в Markdown есть обратные косые черты?
Обратная косая черта показывает, что следующий символ — это текст, а не разметка, например звёздочка или скобка. CommonMark удаляет её при отображении Markdown (раздел 2.4), поэтому страница показывает символы такими, какими они были в HTML.
Инструмент выполняет мой HTML или оставляет его на странице?
Нет. HTML разбирается с помощью DOMParser в отдельный документ, у которого нет контекста просмотра и который не выполняет скрипты. Инструмент копирует текст и структуру и показывает Markdown как текст.
Почему таблицы становятся абзацами?
В CommonMark нет синтаксиса таблиц: таблицы с вертикальными чертами, которые добавляют некоторые сервисы, являются расширением. Каждая ячейка становится абзацем, поэтому слова сохраняются, а раскладка таблицы — нет.
Ссылки и изображения сохраняются?
Да. Элемент a с href становится ссылкой, с её title, если он есть, а img с src становится изображением, альтернативный текст которого экранирован. Другие атрибуты не сохраняются.
Что происходит с элементами, у которых нет формы в Markdown?
Их текст остаётся, а оформление отбрасывается. Например, span, u и mark сохраняют слова внутри себя, а div или section начинают новый абзац текста.
Источники
- CommonMark Spec, версия 0.31.2: разделы 2.4, 4.1, 4.2, 4.4, 4.5, 5.1, 5.2, 6.1, 6.2, 6.3 и 6.7 (на английском)
- WHATWG HTML Standard, раздел 8.5.1, интерфейс DOMParser (на английском)
- MDN (на английском): DOMParser
Цифры и текст в последний раз проверены вторник, 10 ноября 2026 г..