Об этом инструменте
Markdown — это лёгкий синтаксис разметки, который напрямую отображается в подмножество HTML: заголовки, выделение, ссылки, списки, блоки кода, цитаты и таблицы. Этот конвертер преобразует Markdown в HTML с включённым GitHub-flavored Markdown (GFM) — поэтому работают таблицы с вертикальными чертами и зачёркивание — а затем пропускает результат через DOMPurify, прежде чем он попадёт на страницу, удаляя скрипты и небезопасные атрибуты. Обратное направление обходит разобранный DOM HTML и выдаёт чистый Markdown, преобразуя таблицы GFM обратно в синтаксис с вертикальными чертами и сохраняя языки ограждённых блоков кода.
Используйте его, чтобы превратить черновик README или changelog в HTML, который вы можете вставить в CMS, чтобы точно проверить, какой HTML создаёт ваш Markdown, через вид HTML, или чтобы восстановить Markdown из фрагмента HTML, вставленного со страницы документации или из редактора форматированного текста. Переключатель «Предпросмотр / HTML» позволяет оценить отображение и получить исходный код в одном месте, и всё обновляется в реальном времени по мере ввода.
Выходной HTML очищается с помощью DOMPurify перед отображением, поэтому скрипты и атрибуты обработчиков событий из вашего Markdown удаляются — предпросмотр отражает безопасный HTML, а не необработанное преобразование.
Часто задаваемые вопросы
Поддерживает ли этот конвертер GitHub-flavored Markdown (GFM)?
Да. GFM включён, поэтому таблицы с вертикальными чертами, ограждённые блоки кода с указанием языка и ~~зачёркивание~~ преобразуются. Направление HTML в Markdown также выдаёт таблицы GFM с вертикальными чертами.
Безопасно ли использовать сгенерированный HTML напрямую?
HTML очищается с помощью DOMPurify, который удаляет скрипты, обработчики событий и другую небезопасную разметку. Его безопасно отображать, но всегда относитесь с осторожностью к любому HTML, автором которого вы не являетесь, прежде чем публиковать его.
Отправляется ли мой Markdown или HTML на сервер?
Нет. Оба направления выполняются полностью в вашем браузере с помощью JavaScript — парсер marked, DOMPurify и клиентский обходчик DOM. Ничего не отправляется и не сохраняется.