Перейти к содержимому

Направление конвертации

Конвертация MD в HTML

Преобразование MD → HTML на сервере, без установки программ

.md.html

.md.html
  1. Загрузить
  2. Выбрать формат
  3. Скачать

Загрузка файлов

Область приёма файла

или

Файлы MD. До 5 МБ, до 20 файлов за раз. Изображение можно вставить из буфера обмена: Ctrl+V.

Исходники и результаты хранятся 60 минут, затем стираются фоновым уборщиком. Предельный размер файла — 5 МБ, срок хранения — час.

MD и HTML: характеристики

Характеристики форматов MD и HTML рядом
Характеристика.mdMD.htmlHTML
Полное названиеMarkdownHyperText Markup Language
РазработчикДжон Грубер и Аарон ШварцWHATWG (изначально Тим Бернерс-Ли, CERN)
Год появления20041993
Расширения.md, .markdown.html, .htm
MIME-типыtext/markdown, text/x-markdownнет данных
СодержимоеТекстовоеТекстовое
Несколько страниц в файлеНетНет
РазметкаЧитаемый простой текстнет данных
ДиалектыCommonMark, GitHub Flavored Markdownнет данных
ВозможностиЗаголовки, списки, таблицы, блоки коданет данных
ХранениеОбычный текст, удобен для gitнет данных
ОформлениеЗадаётся при преобразованиинет данных
Чем открытьVS Code, Obsidian, Typora, Notepad++, Zettlr, Любой текстовый редакторGoogle Chrome, Mozilla Firefox, Microsoft Edge, VS Code, Notepad++, LibreOffice Writer
СпецификацияОписание форматаОписание формата
MIME-типнет данныхtext/html
Стандартнет данныхHTML Living Standard (WHATWG)
Структуранет данныхДерево элементов, DOM
Ресурсынет данныхСтили, скрипты и картинки — внешние файлы
Кодировканет данныхUTF-8
Просмотрнет данныхЛюбой браузер, без установки программ

Преобразование MD → HTML

HTML — документ, расширение .html, тип text/html, текстовый файл. MD разбирается офисным движком и пересохраняется в HTML. Структура документа переносится точно: расхождений в тексте, стилях и таблицах не возникает.

MD — документ, расширение .md, тип text/markdown, текстовый файл. HTML — документ, расширение .html, тип text/html, текстовый файл. Поддержка HTML шире: его читают Google Chrome, Mozilla Firefox и Microsoft Edge.

Разметка разбирается в дерево: заголовки, списки, таблицы и ссылки получают соответствующие стили целевого формата. Изображения, подключённые внешними ссылками, не загружаются — сервер за ними в сеть не ходит.

Параметров у этого направления нет: значения подобраны так, чтобы результат принимался максимально широко. За одно задание принимается несколько файлов, результат отдаётся отдельными файлами и общим ZIP-архивом. Предельный размер указан в форме загрузки: у каждого направления свой лимит, и он не превышает общего ограничения сервиса.

Вес HTML определяется содержимым — объёмом текста, числом изображений и встроенными шрифтами; отдельного параметра размера у направления нет. Преобразование выполняется на сервере и не зависит от установленного софта: результат одинаков при запуске с любого устройства.

Порядок преобразования MD → HTML

  1. Шаг 1

    Исходный файл

    Поле загрузки принимает несколько файлов MD за одно задание — перетаскиванием или выбором на диске. Формат определяется по сигнатуре содержимого, а не по расширению: переименованный файл распознаётся верно.

  2. Шаг 2

    Параметры

    Настраиваемых параметров у направления MD → HTML нет: набор значений один и подобран под максимальную совместимость результата.

  3. Шаг 3

    Обработка

    Задание ставится в очередь и выполняется на сервере; состояние отображается на странице. Обработка занимает от долей секунды до минуты в зависимости от объёма файла.

  4. Шаг 4

    Результат

    Файлы забираются по одному или общим ZIP-архивом. Ссылка действует один час, после чего исходный файл и результат удаляются с сервера.

Вопросы по работе сервиса

Что именно может измениться в вёрстке?

Положение объектов с абсолютной привязкой, разбивка на колонки, переносы в таблицах и межстрочные интервалы у заменённых шрифтов. Текст, заголовки, списки и содержимое таблиц переносятся полностью. Проверять результат имеет смысл в Google Chrome и Mozilla Firefox на первой и последней странице.

Каков предел размера файла?

Действующее значение показано в форме загрузки: у каждого направления свой предел, он зависит от стоимости преобразования и не превышает общего ограничения сервиса. Ограничение применяется к каждому файлу задания отдельно.

Что требуется на стороне пользователя?

Только браузер: расчёты выполняются на сервере, локальные кодеки и установленные программы на результат не влияют. Регистрация не требуется, водяные знаки на результат не наносятся.

Сколько файлы хранятся на сервере?

Один час с момента загрузки: после этого исходный файл и результат удаляются, а ссылка перестаёт отвечать. Адрес содержит случайный идентификатор, поэтому перебор чужих файлов невозможен.