Перейти к основному содержимому
Конвертация форматов
Конвертация форматов

Markdown → HTML

Перевод книги из Markdown (.md) в Гипертекст (.html, .htm, .xhtml, .xml, .mhtml) — вполне обычный шаг: HTML открывается напрямую в любом браузере и легко встраивается в веб-страницы. К счастью, Markdown и HyperText устроены похоже, так что терять почти нечего. Ниже подробно разберём, как перевести Markdown в HyperText и на что обратить внимание, а в конце статьи — инструмент для конвертации Markdown в HyperText: можно сразу загрузить файл и преобразовать его прямо в браузере.

Редакция YueZhu

What is Markdown?

Markdown — это обычный текст с разметкой (# заголовок, ** жирный, | таблица), по сути надмножество .txt: его откроет любой текстовый редактор, и он отлично подходит для контроля версий. Выразительность у него намеренно ограничена: нет разбивки на страницы, нет колонтитулов, нельзя точно задать кегль и положение — сложную вёрстку на нём не сделать. Из-за этих компромиссов Markdown хорош как отправная точка для написания и конвертации, но как конечный формат для чтения впечатление целиком зависит от того, в какой программе его открыть. Подробнее о формате Markdown

Extensions.md
Typical useТексты, заметки и техническая документация; чистый промежуточный формат для конвертации в EPUB/TXT.

What is HTML?

HTML / XHTML — язык структуры веб-страниц и именно тот формат, в котором EPUB реально хранит текст, так что конвертация между HTML и EPUB по сути сводится к смене оболочки и способа упаковки ресурсов. .mhtml идёт дальше и упаковывает страницу вместе с картинками и стилями в один файл — удобно для сохранения онлайн-страниц, которые в любой момент могут исчезнуть. Плюс HTML в универсальности: его откроет любой браузер; минус в том, что стили и картинки часто подключены по внешним ссылкам, и чтобы «унести всё одним файлом», ресурсы сначала нужно встроить внутрь. Подробнее о формате HTML

Extensions.html.htm.xhtml.xml.mhtml
Typical useИзвлечение основного текста веб-страниц, содержимое внутри EPUB, а также универсальное промежуточное представление для других форматов.

Как преобразовать Markdown в HTML

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

При создании HTML то, являются ли изображения и стили внешними ссылками или встроены, определяет, можно ли распространять файл одним документом. Чтобы «унести всё в одном файле», нужно встроить ресурсы (data URI) или перейти на MHTML; иначе при перемещении файла картинки потеряются. Сохраняйте и семантические теги (h1–h6, p) — тогда при последующей конвертации в EPUB оглавление не пропадёт.

Исходный файл не несёт никаких метаданных (так устроены все простые текстовые форматы вроде TXT и Markdown), а целевой формат ждёт название книги и автора. Конвертер обычно подставляет имя файла, и в библиотеке появляется куча заголовков «Без названия» или с сохранившимся расширением .txt / .md — при конвертации лучше вписать данные вручную.

Инструмент для конвертации Markdown в HTML

MARKDOWN → HTML

Преобразование полностью выполняется в вашем браузере — файлы не отправляются ни на какой сервер.

Средство для чтения романов с синхронизацией прогресса чтения на всех платформах

YueZhu Tide Reader поддерживает TXT и EPUB: при импорте главы распознаются автоматически, вёрстка подстраивается под ваши привычки, а прогресс чтения синхронизируется между Windows, macOS, iOS и Android. Готовый файл достаточно перетащить в окно — и можно читать.

Скачать YueZhu бесплатно

Поддерживаются TXT / EPUB; приоритет — локальное чтение, дополнительно доступны облачная синхронизация и WebDAV.