Конвертер Markdown

Поддерживает двунаправленное преобразование между Markdown и HTML с рендерингом предварительного просмотра в реальном времени. Поддерживает расширенный синтаксис GFM, подсветку кода, математические формулы KaTeX и диаграммы Mermaid, подходит для написания документов, публикации блогов и генерации форматированного текста для электронной почты.

Инструкция по использованию

🚀 Быстрый старт

Вставьте содержимое в левое поле ввода
Выберите режим (→HTML или →Markdown)
Преобразование выполняется автоматически, результат справа
Предпросмотр/вывод HTML: при Markdown → HTML формулы и диаграммы (KaTeX/Mermaid) рендерятся по умолчанию

📌 Частые сценарии

Блоги/доки: быстро проверить рендеринг и цвета
Рассылка: вставить экспортированный HTML в тело письма (желательны inline‑стили)
Rich‑text → Markdown: очистить веб/CMS‑текст для ведения в VCS
Техдок: отрендерить формулы/диаграммы и экспортировать за один шаг
Миграция редактора: согласовать различия диалектов Markdown
Wiki/База знаний: конвертировать HTML‑страницы в Markdown и импортировать
Changelog API: перевести HTML/описания в Markdown для ревью/PR

🎛️ Параметры конвертации и рендеринга

Markdown → HTML: KaTeX/Mermaid рендерятся автоматически
HTML → Markdown: сохраняем/восстанавливаем исходник, без повторного рендеринга
По умолчанию включён GFM (таблицы/чек‑листы); для строгого Markdown используйте базовый синтаксис
По умолчанию включены переносы строк; для строгого поведения — делайте пустые строки между абзацами или ставьте два пробела в конце строки
Очень большие входные данные могут включить пониженный режим предпросмотра (ограничение рендера/отключение подсветки)

🧭 Рекомендации по использованию

Email: применяйте инлайн‑стили для лучшей совместимости
Длинные тексты: конвертируйте частями, чтобы избежать подвисаний

⚠️ Ограничения и совместимость

Диалекты: разные движки рендерят по‑разному; ориентируйтесь на общий синтаксис
HTML → Markdown — попытка восстановления; стили/вёрстка часто теряются
HTML → Markdown игнорирует часть тегов/атрибутов (script/style/meta/base, iframe/object/embed, формы, медиа, on*‑события, style/class и т. п.)
Сложные/вложенные таблицы могут быть упрощены; проверяйте результат
Изображения/видео остаются внешними ссылками, не скачиваются
SVG Mermaid, отрендеренные сторонними сервисами, как правило, не восстанавливаются

🔒 Конфиденциальность и безопасность

Вся обработка выполняется в вашем браузере; данные не покидают ваше устройство
Не выполняет вставленные скрипты <script>
Рендер KaTeX/Mermaid с безопасной конфигурацией
Не выполняется полная очистка HTML; проверяйте до и после конвертации

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

Предпросмотр отличается от рендера на целевой платформе — как понять, в чём дело?

Сначала выясните, какой диалект Markdown использует целевая платформа (CommonMark, GFM или свой). По возможности избегайте сырого HTML и приватных расширений, используйте стандартные переносы (пустые строки между абзацами или два пробела в конце строки). Соберите минимальный пример, проверьте его на платформе, затем постепенно расширяйте объём.

Как безопасно публиковать экспортированный HTML в продакшене?

Инструмент не выполняет <script>, но и не занимается полной очисткой HTML. На стороне сервера или в пайплайне публикации обязательно прогоняйте HTML через библиотеку‑санитайзер с белым списком (например, DOMPurify), запрещайте on*‑обработчики и опасные схемы URI и дополняйте всё строгой CSP‑политикой.

Почему HTML → Markdown портит сложные структуры и как с этим жить?

Старайтесь опираться на переносимые конструкции: переводите вложенные таблицы/списки в более простые таблицы‑пайпы и плоские списки; при необходимости вставляйте как «обычный текст», чтобы убрать span/style/class перед конвертацией. Выделите небольшой пример, добейтесь корректного результата на нём и затем примените те же приёмы к остальному тексту.

Какие ограничения есть у KaTeX/Mermaid и как искать ошибки в формулах/диаграммах?

Синтаксис: KaTeX — блоки $$…$$ или встроенный $…$, Mermaid — в ограждённых блоках ```mermaid. Для больших документов возможен деградированный режим (показ кода, отключение подсветки). Уменьшайте объём, делите документ на части и проверяйте минимальные примеры, чтобы найти проблемный фрагмент. Для восстановления: формулы KaTeX можно получить из отрендеренного HTML, Mermaid‑диаграммы — только если они были созданы этим инструментом и исходник сохранён рядом.