Markdown to HTML Converter
Transform Markdown text into production-ready HTML code with live preview support.
Transform Markdown text into production-ready HTML code with live preview support.
Markdown — это легкий язык разметки, созданный Джоном Грубером в 2004 году, чтобы позволить авторам создавать структурированный HTML, используя соглашения об обычном тексте: символы решетки для заголовков, звездочки для выделения, дефисы для списков, блоки с отступами для кода. Этот формат стал форматом по умолчанию для файлов README, технической документации, черновиков блогов, генераторов статических сайтов и любого контекста, где текст должен читаться как обычный текст и как визуализированный вывод. Преобразование Markdown в HTML — это этап рендеринга, который превращает исходный код в веб-страницу.
Этот конвертер использует отмеченную библиотеку, наиболее широко распространенный механизм рендеринга Markdown в JavaScript. Marked поддерживает CommonMark и GitHub Flavored Markdown (GFM), что означает, что таблицы, изолированные блоки кода, списки задач, зачеркивание и автоматическое связывание работают корректно в дополнение к стандартным функциям Markdown.
Вывод представляет собой простой HTML — семантические теги для заголовков, абзацев, списков, ссылок и изображений, а также перехватчики классов для блоков кода, где их ожидают инструменты подсветки синтаксиса. Выходные данные легко вставляются в любую CMS, встраиваются в генераторы статических сайтов или служат отдельным HTML-файлом. CSS или JavaScript не добавляются; стилизация результата остается на усмотрение вашего последующего контекста.
Markdown — это формат, который предпочитают авторы и разработчики; HTML — это формат, который отображают браузеры. Большинство генераторов статических сайтов и платформ CMS незаметно преобразуют Markdown в HTML, но иногда преобразование требуется как отдельный шаг — вставка в CMS, которая не поддерживает Markdown, создание HTML для электронных писем, быстрый предварительный просмотр или извлечение визуализированного вывода для дальнейшей обработки.
HTML также является каноническим форматом для любого контента, который в конечном итоге будет отображаться в браузере. Информационные бюллетени по электронной почте, созданные на основе черновиков Markdown, страниц документации, встроенных в более крупные HTML-приложения, и сообщений в блогах, вставленных в редакторы, которые ожидают, что HTML выиграет от чистого преобразования.
Вставьте Markdown, получите HTML.
Marked использует двухпроходную архитектуру. Лексер разбивает входные данные на токены уровня блока (заголовки, абзацы, списки, блоки кода) и встроенные токены (выделение, ссылки, изображения). Анализатор проходит поток токенов и генерирует HTML, применяя перехватчики рендеринга для каждого типа токенов.
Расширения Markdown со вкусом GitHub включены по умолчанию: таблицы (с использованием синтаксиса канала), изолированные блоки кода (тройные обратные кавычки с языковыми подсказками), списки задач (- [ ] и - [x]), зачеркивание (с использованием двойных тильд) и автоматическое связывание URL-адресов. Блоки кода создают предварительно завернутый код с дополнительным языковым классом для подсветки синтаксиса в дальнейшем.
Обеззараживание продукции остается на усмотрение последующих потребителей. Marked генерирует все, что выдает входные данные, включая необработанный HTML, встроенный в Markdown. Если вы принимаете ненадежные входные данные, запустите выходные данные через DOMPurify или аналогичное средство очистки HTML перед рендерингом в браузере.