MD
Markdown
Исходный формат
HTML
HTML
Целевой формат

Конвертировать Markdown в HTML

Из README или любой .md заметки получите готовую самодостаточную HTML-страницу со встроенным CSS, GFM-таблицами, чек-листами и подсветкой кода — без внешних зависимостей.

Перетащите .md файлы сюда

или выберите Markdown / .markdown для конвертации в HTML

Самодостаточный HTML

Inline-CSS в стиле GitHub встраивается прямо в head — страница работает без сети

GFM плагины

Таблицы, чек-листы, footnotes, strikethrough и автолинки — всё включено по умолчанию

Подсветка кода inline

Pygments с noclasses=True раскрашивает блоки кода прямо в style-атрибутах

О форматах

Markdown и HTML глазами парсера

MD

Markdown формат

CommonMark / GitHub Flavored Markdown

Markdown — текстовый формат с минимальным синтаксисом для заголовков, списков, ссылок и блоков кода. Спецификация CommonMark 0.31 однозначно описывает поведение, а GFM добавляет таблицы, tasklists, autolinks, strikethrough и расширенные правила экранирования.

СтандартCommonMark + GFM
Парсерmarkdown-it-py
Расширенияtables, tasks, footnotes
КодировкаUTF-8
HTML

HTML формат

HyperText Markup Language

HTML описан спецификацией HTML Living Standard (WHATWG). На выходе мы формируем валидный HTML5-документ: doctype, meta charset UTF-8, viewport, встроенный CSS GitHub-стиля и semantic-теги (article, header, code, table, blockquote). Файл открывается локально без сервера.

СтандартHTML Living Standard
DOCTYPEHTML5
CSSInline в head
ЗависимостиНет внешних

Сравнение форматов

Почему MD пишут руками, а HTML отдают браузеру

ХарактеристикаMDHTML
Удобный синтаксис для людей
Хорошие diff в Git
Сразу открывается в браузере
Поддержка стилизации CSS
Семантические теги
Минимальный вес файла
Готов к публикации на сайте

Как конвертировать

Три шага до готовой HTML-страницы

1

Загрузите Markdown

Перетащите .md или .markdown — допускаются GFM-таблицы, чек-листы, сноски, fenced-блоки кода с указанием языка.

2

Embedded CSS

markdown-it-py с GFM-плагинами рендерит документ, Pygments раскрашивает код, в head встраивается готовый CSS GitHub-стиля.

3

Скачайте HTML

Готовая страница без внешних CDN — открывается двойным кликом, заливается в S3 или вкладывается в письмо.

Частые вопросы

Самодостаточность вывода и тонкости расширений

Это значит, что результирующий .html файл не подгружает ни одного внешнего ресурса по сети. Весь CSS встраивается внутрь тега style в head, цвета подсветки кода — прямо в style-атрибуты тегов span (Pygments noclasses=True). Файл можно положить в архив, отправить почтой, открыть offline на сервере без интернета — он откроется и отрендерится одинаково.
Используется пресет markdown-it gfm-like плюс mdit-py-plugins: footnote (сноски [^1]), tasklists (списки задач [ ]/[x]), strikethrough (~~text~~), table (с выравниванием), autolink (голые URL), anchors (id у заголовков для якорных ссылок). Всё это включено по умолчанию, отключается флагами в опциях.
Да, передайте опцию full_document=false и конвертер вернёт только HTML-фрагмент: набор article / h1 / p / ul / pre тегов без doctype, head и body. Это удобно если вы вставляете результат в шаблонизатор Jinja/Django или в WYSIWYG-редактор, где обёртка уже своя.
По спецификации CommonMark inline и block-level HTML внутри Markdown проходит насквозь без экранирования. Это удобно для kbd, sub, sup, details/summary. Для безопасности можно передать sanitize=true — тогда теги script, iframe, style, on*-атрибуты вырезаются, остальной HTML сохраняется как есть.
По умолчанию подключается светлая GitHub-подобная тема: системный sans-serif шрифт (-apple-system, Segoe UI, Roboto), font-size 16px, max-width контейнера 980px, аккуратные отступы у заголовков, серый фон у inline-кода и pre-блоков, тонкие границы у таблиц и blockquote с левой полосой. Можно переключиться на github-dark через опцию theme=dark.

Готовы превратить Markdown в HTML?

Загрузите README или статью — получите самодостаточную HTML-страницу за пару секунд

Начать конвертацию