Pandoc конвертирует TXT в EPUB без лишних стилей, что даёт минимальный размер файла.

pandoc input.txt -o output.epub \
  --epub-chapter-level=2 \
  --metadata title="Моя книга" \
  --metadata author="Автор" \
  --css style.css

Опции:

• --epub-chapter-level=2 — уровень заголовков, с которого начинается глава (1 — h1, 2 — h2).
• --metadata — автор, заголовок и т.д.
• --css — пути к CSS-стилям (опционально).

Edge-case: Pandoc по умолчанию не обрабатывает пустые строки как разделители глав. Добавьте --epub-subdirectory=OEBPS для корректной структуры.

Для программной конвертации используйте библиотеку ebooklib.

from ebooklib import epub
book = epub.EpubBook()
book.set_identifier('id_12345')
book.set_title('Моя книга')
book.set_language('ru')

# Добавляем стиль
style = 'body { font-family: serif; }'
nav_css = epub.EpubItem(uid="style", file_name="style.css", media_type="text/css", content=style.encode())
book.add_item(nav_css)

# Читаем TXT
with open('input.txt', 'r', encoding='utf-8') as f:
    text = f.read()

# Создаём главу (первый абзац как заголовок)
lines = text.split('\n\n')
for i, chunk in enumerate(lines):
    chapter = epub.EpubHtml(title=f'Глава {i+1}', file_name=f'chap_{i+1}.xhtml', lang='ru')
    chapter.content = f'
Глава {i+1}
{chunk}
'
    book.add_item(chapter)
    book.toc.append(epub.Link(f'chap_{i+1}.xhtml', f'Глава {i+1}', f'chap_{i+1}'))
    book.add_item(epub.EpubNcx())
    book.add_item(epub.EpubNav())

epub.write_epub('output.epub', book, {})

Рекомендация: проверьте кодировку входного файла — chardet или codecs.

EPUB без оглавления — просто zip-архив с HTML. В ридерах (Kindle, PocketBook) навигация обязательна.

• Calibre: использует XPath //h:h1 для поиска заголовков.
• Pandoc: по умолчанию создаёт оглавление из заголовков Markdown (уровень 1-2).
• Ручная вёрстка: в Python через epub.Link.

Если в исходном TXT нет заголовков, добавьте строку вида # Глава 1 (Markdown) перед каждой частью.

Ошибки при конвертации делятся на три категории.