Markdown в EPUB: конвертация с сохранением разметки
- Pandoc — стандарт конвертации MD→EPUB, поддерживает 90% Markdown-разметки, включая таблицы и код, а также генерирует оглавление по заголовкам.
- Кастомные CSS-стили в Meta-блоке Markdown позволяют управлять оформлением EPUB без ручного редактирования
- Онлайн-конвертер на сайте — самый быстрый способ для разовых задач: не требует установки и даёт готовый файл за минуту.
- Проблема кодировок решается явным указанием --metadata lang=ru-RU в Pandoc или выбором UTF-8 в онлайн-инструментах.
- Для вложенных списков и сложных таблиц в Markdown после конвертации может потребоваться доработка CSS — лучше тестировать на читалке.
- 1. Почему Markdown → EPUB проще, чем верстать вручную
- 2. Pandoc — профессиональный конвертер с полным контролем
- 3. Онлайн-инструменты: когда не хочется возиться с консолью
- 4. Настройка стилей EPUB через CSS и YAML-метаданные
- 5. Таблицы, списки, код: что поддерживается, что нет
- 6. Подводные камни и их решения
- 7. Отладка результата: как проверить EPUB
- 8. Дополнительные конвертации: из и в другие форматы
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 |
Обратите внимание на lang=ru-RU — это решает проблему с переносами и кодировкой в российских читалках.
3. Онлайн-инструменты: когда не хочется возиться с консолью
Для быстрой конвертации без установки ПО используйте веб-сервисы. Лучшие варианты на 2026 год:
- Markdown в EPUB на нашем сайте — сохраняет форматирование, поддерживает таблицы, списки и встроенные изображения в
<img>. Достаточно загрузить .md файл или вставить текст. - TXT в EPUB — если у вас уже текст без разметки и нужно быстро сделать читабельный EPUB.
- 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.
Если вы пользуетесь онлайн-инструментом Markdown в EPUB, можно вставить CSS-блок в специальное поле настроек — стили применятся автоматически.
- 1Подготовка MD
Убедитесь, что Markdown совместим с Pandoc: используйте стандартный синтаксис, таблицы, изображения.
- 2Настройка метаданных
Добавьте YAML-блок с title, author, lang=ru-RU, обложкой.
- 3Выбор конвертера
Для кастомного стиля — Pandoc, для быстрой одноразовой — онлайн-конвертер.
- 4Конвертация
Выполните команду pandoc или загрузите файл в веб-инструмент.
- 5Проверка оглавления
Откройте EPUB в читалке или редакторе, проверьте кликабельность TOC.
- 6Финальная отладка
Исправьте CSS, кодировку, пути к изображениям при необходимости.
- 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
После конвертации нужно удостовериться, что файл корректен. Инструменты:
- Calibre (бесплатен) — импортируйте EPUB и откройте в редакторе. Он покажет ошибки разметки. Также через View → «Просмотр» вы увидите книгу как на читалке.
- EPUB 3 Validator — онлайн (validator.idpf.org) проверяет соответствие стандарту.
- Sigil — редактор EPUB, позволяет исправить код вручную, если что-то пошло не так.
- Глаза — откройте на смартфоне (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.
Источники и нормативные документы
- Pandoc — официальная документация
- Спецификация Markdown от John Gruber
- EPUB 3.0 — стандарт IDPF (W3C)
- Calibre — официальный сайт
- Книга «Маркдаун — практическое руководство»