Предпросмотр Markdown
Готовый вариант «Markdown в HTML»
Пишите Markdown и мгновенно видите результат рендеринга. Полезно для черновика README, описания pull request или документации перед публикацией — предпросмотр изолирован в защищённом фрейме, поэтому вставленный контент ничего не может выполнить.
- Файлы никогда не покидают ваше устройство
- Бесплатно, без регистрации
- Без водяных знаков
- Работает офлайн после загрузки
Как пользоваться: markdown в html
- 1
Введите или вставьте Markdown
HTML-код и предпросмотр обновляются по мере ввода.
- 2
Проверьте предпросмотр
Он отображается в изолированном фрейме, поэтому вставленный контент не может запускать скрипты.
- 3
Скопируйте HTML
Скопируйте разметку или скачайте её в виде файла .html.
Почему черновик с предпросмотром лучше, чем угадывание синтаксиса вслепую
Вся привлекательность Markdown в том, что его можно писать и читать как обычный текст, но именно эта простота делает некоторые ошибки незаметными до момента рендеринга — таблица, в строке-разделителе которой не хватает одной вертикальной черты, незаметно превращается обратно в обычный абзац вместо таблицы, вложенный список с неверным числом пробелов отступа прикрепляется не к тому родительскому пункту, и ни для одной из этих проблем нет сообщения об ошибке — просто результат, который незаметно выглядит не так, как задумывалось. Видя, как результат рендеринга обновляется непрерывно по мере написания текста, вы ловите именно такие ошибки форматирования в момент их появления, а это значительно быстрее, чем написать весь README или описание pull request вслепую и обнаружить, что форматирование сломано, только после того, как оно уже где-то опубликовано.
Черновик под конкретную площадку публикации
GitHub, сайт документации и форумный пост могут в пограничных случаях слегка по-разному отрендерить один и тот же исходный текст Markdown, даже если все они в целом поддерживают GFM, поэтому предпросмотр перед публикацией особенно важен, когда площадка такова, что ошибка рендеринга будет видна широкой аудитории, — публичный README, анонс релиза или описание pull request, которое ревьюеры действительно внимательно прочитают.
Часто задаваемые вопросы
Какой диалект Markdown поддерживается?
GitHub Flavored Markdown: таблицы, блоки кода, списки задач, зачёркивание и автоматические ссылки поверх ядра CommonMark. Это диалект, который используют GitHub, Reddit и большинство генераторов статических сайтов.
Безопасно ли вставлять Markdown из ненадёжного источника?
Предпросмотр отображается в изолированном iframe с отключённым выполнением скриптов, поэтому встроенные теги `<script>` и обработчики событий выполняться не могут. Учтите, что *сгенерированный HTML* по-прежнему содержит весь необработанный HTML, который был в вашем Markdown, — санитизируйте его на сервере перед публикацией контента, который написали не вы.
Поддерживается ли необработанный HTML внутри Markdown?
Да — Markdown допускает встроенный HTML, и он передаётся без изменений. Именно поэтому важно предупреждение о санитизации выше, если источник ненадёжен.
Почему моя таблица не отображается?
Таблицам GFM нужна строка-разделитель из дефисов под заголовком, а если таблица идёт сразу после абзаца — ещё и пустая строка перед ней. Отсутствие всего одной вертикальной черты в строке-разделителе незаметно превращает всю таблицу обратно в обычный текст.