Markdown в EPUB: конвертация с сохранением разметки

💻 IT и кодОбновлено: 13 июля 2026 г.6 мин чтения
Вы написали книгу или документацию в Markdown, а теперь нужно получить читабельный EPUB. Ручная верстка электронных книг — ад: потеря форматирования, кривые заголовки, отсутствие оглавления. В этой статье — проверенные способы конвертации от Pandoc до онлайн-инструментов, качество результатов и подводные камни.
⚡ Коротко: главное
  • Pandoc — стандарт конвертации MD→EPUB, поддерживает 90% Markdown-разметки, включая таблицы и код, а также генерирует оглавление по заголовкам.
  • Кастомные CSS-стили в Meta-блоке Markdown позволяют управлять оформлением EPUB без ручного редактирования
  • Онлайн-конвертер на сайте — самый быстрый способ для разовых задач: не требует установки и даёт готовый файл за минуту.
  • Проблема кодировок решается явным указанием --metadata lang=ru-RU в Pandoc или выбором UTF-8 в онлайн-инструментах.
  • Для вложенных списков и сложных таблиц в Markdown после конвертации может потребоваться доработка CSS — лучше тестировать на читалке.

1. Почему Markdown → EPUB проще, чем верстать вручную

Markdown — лёгкий синтаксис, который превращается в структурно правильный EPUB: заголовки, параграфы, списки. Вам не нужно думать о тегах <h1> или <p>. Всё, что вы пишете в MD, автоматически становится семантически верной электронной книгой.

Сравните: в InDesign или Sigil правка каждой главы занимает часы. При конвертации MD→EPUB изменения вносятся в исходник — и книга пересобирается за секунды.

Важно: не все Markdown-диалекты одинаковы. Стандартный Pandoc Markdown (используемый в Pandoc, а также в некоторых онлайн-инструментах) понимает таблицы, сноски, списки задач и даже математику. Если вы пишете в GitHub Flavored Markdown, проверьте поддержку форматирования перед конвертацией.

Флагманский инструмент нашего сайта — Markdown в EPUB. Он не требует установки, обрабатывает файлы прямо в браузере и выгружает готовый EPUB. Отлично подходит для быстрых задач.

2. Pandoc — профессиональный конвертер с полным контролем

Если вам нужна максимальная кастомизация — берите Pandoc. Это утилита командной строки, которая конвертирует между сотнями форматов, включая MD→EPUB.

Установка: sudo apt install pandoc (Linux), brew install pandoc (macOS), на Windows — скачать с pandoc.org.

Базовая команда:

pandoc input.md -o output.epub

Управление оглавлением, стилями, метаданными — через параметры:

ПараметрНазначениеПример
--tocГенерация оглавления--toc
--css style.cssПодключение собственного CSS--css epub.css
--metadata title:"Моя книга"Установка метаданных (автор, язык)--metadata title:"История" --metadata author:"Я"
--epub-cover-image cover.jpgДобавление обложки--epub-cover-image cover.jpg
Идеальный вызов: pandoc book.md -o book.epub --toc --metadata lang=ru-RU --css epub.css

Обратите внимание на lang=ru-RU — это решает проблему с переносами и кодировкой в российских читалках.

3. Онлайн-инструменты: когда не хочется возиться с консолью

Для быстрой конвертации без установки ПО используйте веб-сервисы. Лучшие варианты на 2026 год:

  1. Markdown в EPUB на нашем сайте — сохраняет форматирование, поддерживает таблицы, списки и встроенные изображения в <img>. Достаточно загрузить .md файл или вставить текст.
  2. TXT в EPUB — если у вас уже текст без разметки и нужно быстро сделать читабельный EPUB.
  3. E-PUB Converter Online (epubconverter.com) — дополнительный вариант для больших файлов до 50 МБ, но с рекламой.

Процесс во всех сервисах однотипен: загрузка файла, настройка метаданных (название, автор), кнопка «Конвертировать». Результат — файл .epub стандарта EPUB 3.0.

Подводный камень: некоторые онлайн-конвертеры не обрабатывают относительные пути к изображениям. Заранее упакуйте картинки в zip-архив или вставьте их base64-кодом в Markdown. Наш инструмент автоматически загружает все прикреплённые изображения.

4. Настройка стилей EPUB через CSS и YAML-метаданные

Качественный EPUB — это не только текст, но и вёрстка: шрифты, отступы, переносы. Управлять стилями можно двумя способами:

  • Внешний CSS-файл — создайте файл style.css и укажите его в Pandoc через --css style.css.
  • YAML-метаданные в начале MD-файла — блок с настройками, который Pandoc прочитает. Пример:
---
title: "Моя книга"
author: "Автор"
lang: ru-RU
cover-image: cover.jpg
...

Пример CSS для EPUB:

body { font-family: 'Georgia', serif; line-height: 1.5; margin: 5%; }
h1 { text-align: center; font-size: 2em; page-break-before: always; }
p { text-indent: 1.5em; }

Чтобы увидеть, как книга выглядит на реальном устройстве, используйте эмулятор или загрузите в программу для чтения — например, Calibre Viewer.

Команда для сборки с CSS: pandoc --css=style.yml --toc -o book.epub book.md

Если вы пользуетесь онлайн-инструментом Markdown в EPUB, можно вставить CSS-блок в специальное поле настроек — стили применятся автоматически.

Процесс конвертации MD в EPUB
  1. 1
    Подготовка MD

    Убедитесь, что Markdown совместим с Pandoc: используйте стандартный синтаксис, таблицы, изображения.

  2. 2
    Настройка метаданных

    Добавьте YAML-блок с title, author, lang=ru-RU, обложкой.

  3. 3
    Выбор конвертера

    Для кастомного стиля — Pandoc, для быстрой одноразовой — онлайн-конвертер.

  4. 4
    Конвертация

    Выполните команду pandoc или загрузите файл в веб-инструмент.

  5. 5
    Проверка оглавления

    Откройте EPUB в читалке или редакторе, проверьте кликабельность TOC.

  6. 6
    Финальная отладка

    Исправьте CSS, кодировку, пути к изображениям при необходимости.

  7. 7
    Выгрузка

    Скачайте готовый EPUB и используйте на любом устройстве.

От подготовки исходника до готовой книги.

5. Таблицы, списки, код: что поддерживается, что нет

Markdown богат возможностями, но не все из них корректно переносятся в EPUB. Приведём сравнительную таблицу:

ЭлементPandocОнлайн-конвертер*Примечание
Обычный текст
Заголовки #, ##Генерируют оглавление при --toc
Таблицы GFMТребуют пустой строки до/после
Код `inline`Остаётся моноширинным
Блоки кода ```Оборачиваются в <pre>
Списки задач - [ ]~(только Q)Pandoc превращает в <ul> с классом
Сноски [^1]Не поддерживаются обычными конвертерами
Математика LaTeXТребует MathML
Изображения ![]()Размер задаётся через { width=50% }

* — типовой онлайн-конвертер без Pandoc.

Для сложных таблиц (объединённые ячейки) Markdown не годится — придётся редактировать HTML внутри.

Чеклист: идеальный EPUB из Markdown

0 из 10

6. Подводные камни и их решения

  • Кодировка. Если русский текст превращается в кракозябры, явно укажите кодировку. В Pandoc: --metadata lang=ru-RU; в онлайн-инструменте — убедитесь, что файл сохранён в UTF-8 без BOM.
  • Изображения не отображаются. Пути в HTML EPUB должны быть относительными. Если используете Pandoc, поместите картинки в папку и укажите --resource-path=./images/. В онлайн-версии — приложите архив с изображениями.
  • Оглавление не кликабельно. В Pandoc добавьте флаг --toc. В онлайн-конвертере оглавление обычно генерируется автоматически из заголовков.
  • CSS не применяется. Проверьте синтаксис CSS: не должно быть ошибок. Убедитесь, что в EPUB присутствует ссылка на stylesheet.

Самый частый совет: используйте инструмент на нашем сайте — Markdown в EPUB, он устраняет большинство типовых проблем.

7. Отладка результата: как проверить EPUB

После конвертации нужно удостовериться, что файл корректен. Инструменты:

  1. Calibre (бесплатен) — импортируйте EPUB и откройте в редакторе. Он покажет ошибки разметки. Также через View → «Просмотр» вы увидите книгу как на читалке.
  2. EPUB 3 Validator — онлайн (validator.idpf.org) проверяет соответствие стандарту.
  3. Sigil — редактор EPUB, позволяет исправить код вручную, если что-то пошло не так.
  4. Глаза — откройте на смартфоне (Google Play Books, iBooks) или в десктопной программе (Adobe Digital Editions).

Типичные проблемы: отсутствие CSS, битые ссылки внутри оглавления, нечитаемые символы. Всё это лечится настройками Pandoc или выбором другого онлайн-инструмента.

Если после конвертации оглавление не работает — откройте EPUB в Sigil и проверьте ссылки href в файле toc.ncx или nav.xhtml. Иногда нужно вручную подправить пути.

8. Дополнительные конвертации: из и в другие форматы

Если ваш исходный материал не Markdown, а TXT, или вам нужен EPUB в другом формате, воспользуйтесь инструментами на нашем сайте:

  • TXT в EPUB — подойдёт для чистого текста, автоматически разбивает на абзацы.
  • EPUB в FB2 — для читалок, которые предпочитают FictionBook.
  • EPUB в PDF — когда нужно распечатать или сохранить фиксированную вёрстку.
  • EPUB в TXT — если нужно извлечь текст для поисковых систем или анализа.

Все инструменты работают онлайн, сохраняют базовое форматирование и не требуют регистрации.

🧮 Посчитайте сами — инструменты по теме

🧭 Разделы по теме

Частые вопросы

Какой онлайн-конвертер Markdown в EPUB лучший на сегодня?

Лучший выбор — наш сервис «Markdown в EPUB» (встроенная обработка изображений, поддержка сквозных таблиц, автогенерация оглавления). Альтернативы: Pandoc (профессиональный, требует установки) или CloudConvert для редких форматов.

Можно ли конвертировать Markdown в EPUB с сохранением переносов и отступов?

Да, для этого нужно приложить кастомный CSS. В Pandoc это делается через --css=style.css. В нашем онлайн-конвертере предусмотрено поле для ввода стилей. Обязательно пропишите line-height, margin и text-indent.

Почему в получившемся EPUB пропали изображения?

Скорее всего, пути к изображениям относительные и не были включены в архив EPUB. В Pandoc используйте --resource-path=./images/. В онлайн-конвертере приложите zip с картинками или вставьте их base64-строкой в MD.

Как добавить оглавление в EPUB при конвертации Markdown?

В Pandoc добавьте флаг --toc. В нашем онлайн-инструменте опция включена по умолчанию. После конвертации проверьте файл в читалке: оглавление должно быть кликабельным и отображать заголовки первого-третьего уровней.

Как конвертировать Markdown в EPUB с сохранением кода?

Используйте блоки кода с ```. Pandoc оборачивает их в c CSS-классом. При желании вы можете добавить стили для подсветки синтаксиса вручную или через сторонний плагин.

Что делать, если русский текст в EPUB отображается как кракозябры?

Укажите кодировку UTF-8 и язык ru-RU. В Pandoc добавьте --metadata lang=ru-RU. В онлайн-конвертере — перед конвертацией пересохраните MD в UTF-8 без BOM. Также проверьте CSS, чтобы не было конфликта шрифтов.

Можно ли конвертировать Markdown в EPUB с помощью Android/iOS приложения?

Да, для Android есть Pandroide (пакет Termux + Pandoc) или приложение AIDE Markdown. Для iOS — Working Copy с Pandoc. Но проще использовать мобильную версию нашего онлайн-конвертера через браузер.

Как конвертировать EPUB обратно в Markdown для редактирования?

Используйте Pandoc: pandoc book.epub -o book.md. Для онлайн-конвертации — наш инструмент «EPUB в TXT» (сохраняет текст без разметки) или «EPUB в FB2» с последующей конвертацией. Для точного восстановления разметки лучше Pandoc.

Источники и нормативные документы

  1. Pandoc — официальная документация
  2. Спецификация Markdown от John Gruber
  3. EPUB 3.0 — стандарт IDPF (W3C)
  4. Calibre — официальный сайт
  5. Книга «Маркдаун — практическое руководство»

Ещё по теме «IT и код»