Markdown в HTML

Что делает конвертер Markdown в HTML

Конвертер Markdown в HTML превращает текстовую разметку в HTML и показывает ее в предпросмотре. Можно переключиться на вкладку «Код», скопировать результат или скачать HTML-фрагмент для дальнейшей публикации.

Как Markdown задает оформление

Markdown обозначает структуру обычными символами: # перед заголовком, звездочками для выделения, дефисами для списка и обратными кавычками для кода. При преобразовании этим конструкциям соответствуют HTML-элементы, например h1, strong, ul и code.

HTML описывает структуру страницы. Цвета, гарнитура, отступы и другое оформление зависят от CSS сайта, поэтому предпросмотр здесь не обещает полного совпадения с будущей публикацией.

Структура документа и визуальное оформление

Заголовки Markdown становятся заголовками HTML соответствующего уровня. Уровень обозначает место в иерархии документа, а не только размер шрифта. Для вставляемого блока выбирайте уровень с учетом страницы, где уже может быть главный H1.

Список, абзац и перевод строки тоже не равнозначны. Обычный перенос внутри абзаца не обязательно становится отдельным HTML-элементом br. Если после вставки несколько строк выглядят как одна, сначала проверьте правила Markdown и полученный код, а не добавляйте случайные пустые теги.

Блок кода и буквальный HTML

Обратные кавычки помогают показать программный текст как содержимое, а не как разметку документа. В кодовом блоке символы < и > должны оставаться видимыми знаками исходника. Встроенный HTML, напротив, передается на обработку как разметка и затем проходит фильтр разрешенных элементов.

Для статьи о HTML важно выбрать именно первый вариант, если пользователь должен увидеть теги. Предпросмотр помогает обнаружить ошибку контекста: исчезнувший тег в обычном тексте мог быть интерпретирован как элемент, а не потерян при копировании. Сохраненный файл здесь содержит фрагмент; оформление кодовых блоков на конечном сайте задается отдельно.

Работа с текстом и предпросмотром

Вставьте Markdown в «Исходный текст». Результат обновится автоматически. На вкладке «Предпросмотр» проверьте иерархию заголовков, списки и блоки кода; на вкладке «Код» посмотрите полученные теги.

Предпросмотр изолирован от страницы. Он не открывает ссылки и не загружает внешние изображения или встраивания. В нем дополнительно удаляются атрибуты, поэтому просмотр не полностью воспроизводит содержимое выходного HTML-кода.

Какие конструкции удаляются

После преобразования применяется фильтрация HTML. Скрипты, обработчики событий, встроенные стили и неподдерживаемые элементы удаляются. Изображения с разрешенным src сохраняются в HTML-коде, но отсутствуют в предпросмотре. Для ссылок оставляются только разрешенные варианты адресов. Разметка, рассчитанная на JavaScript-виджеты, здесь не воспроизводится.

На выходе получается фрагмент, а не полный документ с head, стилями и навигацией. При вставке в CMS или шаблон проверьте требования принимающей системы: она может дополнительно менять или фильтровать HTML. Не пропускайте повторную проверку только потому, что фрагмент уже был обработан этой страницей.