Безкоштовний конвертер

Уцінка до HTML конвертер

Перетворюйте текст Markdown у готовий для виробництва HTML-код із підтримкою попереднього перегляду.

Про цей інструмент

Markdown — це полегшена мова розмітки, створена Джоном Грубером у 2004 році, щоб дозволити авторам створювати структурований HTML, використовуючи стандарти звичайного тексту: символи решітки для заголовків, зірочки для виділення, дефіси для списків, блоки з відступами для коду. Формат став типовим для файлів README, технічної документації, чернеток блогів, генераторів статичних сайтів і будь-якого контексту, де текст має бути читаним як звичайний текст і як відтворений вихід. Перетворення Markdown у HTML — це крок візуалізації, який перетворює джерело на веб-сторінку.

Цей конвертер використовує позначену бібліотеку, найпоширеніший рендерер Markdown у JavaScript. Marked підтримує CommonMark і GitHub Flavored Markdown (GFM), що означає, що таблиці, виділені блоки коду, списки завдань, закреслення та автоматичне посилання працюють належним чином на додаток до стандартних функцій Markdown.

Вихід — звичайний HTML — семантичні теги для заголовків, абзаців, списків, посилань і зображень, а також хуки класів для блоків коду, де їх очікують інструменти підсвічування синтаксису. Вихідні дані акуратно вставте в будь-яку CMS, вбудуйте в генератори статичних сайтів або слугуйте як окремий .html. Не додано CSS або JavaScript; стилізація результату залежить від вашого контексту.

Навіщо конвертувати Markdown у HTML

Markdown — це формат, якому надають перевагу автори та розробники; HTML – це формат, який відтворюють браузери. Більшість генераторів статичних сайтів і платформ CMS перетворюють Markdown на HTML за лаштунками, але інколи вам потрібне перетворення як окремий крок — вставлення в CMS, яка не підтримує Markdown, генерування HTML для електронних листів, створення швидкого попереднього перегляду або витягування відтворених результатів для подальшої обробки.

HTML також є канонічним форматом для будь-якого вмісту, який зрештою відображатиметься у браузері. Інформаційні бюлетені електронної пошти, створені з чернеток Markdown, сторінок документації, вбудованих у великі HTML-програми, і публікацій блогу, вставлених у редактори, які очікують HTML, — усе це виграє від чистого перетворення.

Як використовувати

Вставте Markdown, отримайте HTML.

  1. Додайте свій Markdown: Вставте текст Markdown у область введення або перетягніть файл .md. Працює як стандартний синтаксис Markdown, так і GitHub Flavored Markdown.
  2. конвертувати: Marked аналізує Markdown на AST і видає HTML. Стандартні вбудовані елементи (підкреслення, посилення, посилання, код, зображення), блокові елементи (заголовки, абзаци, списки, цитати) і розширення GFM (таблиці, виділений код, списки завдань, автопосилання) відображаються правильно.
  3. Попередній перегляд: Перегляньте відтворений HTML на панелі попереднього перегляду. Переконайтеся, що блоки коду, таблиці та інші складні елементи відображаються належним чином.
  4. Скопіюйте або завантажте: Скопіюйте HTML у буфер обміну для вставлення в CMS або збережіть як .html для автономного використання. Результатом є семантичний HTML5 без вбудованих стилів.

Загальні випадки використання

Технічні деталі

Marked використовує двопрохідну архітектуру. Лексер розміщує вхідні дані в маркери рівня блоку (заголовки, абзаци, списки, блоки коду) і вбудовані маркери (виділення, посилання, зображення). Синтаксичний аналізатор проходить по потоці маркерів і видає HTML, застосовуючи хуки рендерера для кожного типу маркерів.

Розширення GitHub Flavored Markdown увімкнено за замовчуванням: таблиці (з використанням синтаксису вертикальної лінії), виділені блоки коду (потрійні зворотні галочки з мовними підказками), списки завдань (- [ ] і - [x]), закреслення (з використанням подвійних тильд) і автоматичне посилання на URL-адресу. Блоки коду створюють попередньо обгорнутий код із додатковим класом мови для підсвічування синтаксису.

Санітарна обробка вихідної продукції покладена на подальших споживачів. Marked видає все, що створює введення, включаючи необроблений HTML, вбудований у Markdown. Якщо ви приймаєте ненадійні вхідні дані, запустіть вихідні дані через DOMPurify або подібний засіб очищення HTML перед рендерингом у браузері.

Найкращі практики

Поширені запитання

Перетворення MARKDOWN на HTML змінює вміст?
Вміст збережено максимально точно. Проте деякі особливості формату можуть не мати прямих еквівалентів, тому можуть виникнути незначні відмінності у форматуванні.
Для чого використовується формат HTML?
HTML (мова розмітки гіпертексту) в основному використовується для веб-сторінок і веб-вмісту.
Чи є якісь обмеження, про які варто знати?
Підтримуються файли розміром до 50 МБ. Обробка дуже великих або складних файлів може тривати довше. Усі перетворення відбуваються у вашому браузері, тому швидкість обробки залежить від вашого пристрою.
Чи це перетворення безпечне та конфіденційне?
так Уся обробка відбувається локально у вашому браузері. Ваші дані ніколи не залишають ваш пристрій — без завантаження на сервер, без обробки в хмарі, без збору даних.
Чи підтримуються емодзі?
Смайли Unicode проходять напряму (введення емодзі-сердечка показує серце на виводі). Шорткоди у стилі GitHub :emoji: не конвертуються за замовчуванням; додайте розширення, якщо вам це потрібно.
Чи завантажено мій Markdown на сервер?
Ні. Позначений запускається у вашому браузері; перетворення відбувається повністю на вашому пристрої.
Чи можу я додати власний стиль до HTML?
Так, після перетворення. Вихід - звичайний семантичний HTML; застосувати власний CSS до заголовків стилів, блоків коду, таблиць та інших елементів.
Чи підтримує він виноски?
Стандартний CommonMark не визначає синтаксис виноски. Деякі розширення Markdown підтримують синтаксис виноски [^1]; цей конвертер відповідає GFM, який не містить виносок.