Book production pipeline for authors and self-publishers.

Multi-format export (PDF, EPUB, DOCX, HTML, Markdown), audiobook generation, translation, and manuscript tooling, powered by Pandoc.

pip install manuscripta

Or with Poetry:

poetry add manuscripta

• Python 3.11+
• Pandoc installed and available on PATH
• For audiobook generation: internet connection (Edge TTS) or local TTS engine

Inside your book repository root:

# Export to PDF
export-pdf

# Export to EPUB with cover
export-ewc --cover assets/covers/cover.jpg

# Export all formats
export-all

# Safe export (no source modifications, good for drafts)
export-pdf-safe

# Generate audiobook
manuscripta-audiobook --engine edge --voice en-US-JennyNeural

# Initialize a new book project
manuscripta-init

Each book repository should follow this layout:

my-book/
  manuscript/
    front-matter/
      toc.md
      toc-print.md
      foreword.md
      preface.md
    chapters/
      01-chapter-one.md
      02-chapter-two.md
    back-matter/
      epilogue.md
      glossary.md
      acknowledgments.md
      about-the-author.md
      bibliography.md
      imprint.md
  config/
    metadata.yaml
    export-settings.yaml
    voice-settings.yaml
  assets/
    covers/
    images/
    fonts/
    templates/
  output/
  pyproject.toml

Images referenced from your Markdown (![alt](images/foo.png)) are resolved against the book repository's assets/ directory. As of v0.8.0 the library has an explicit contract about where that directory lives — the caller passes it in, there is no cwd fallback inside the library.

Invoke from the project root (default behavior — cwd is used as the source dir at the CLI layer):

export-pdf

Or pass --source-dir explicitly to build from anywhere:

export-pdf --source-dir=/path/to/my-book

Missing images fail the build by default. Opt out with --no-strict-images to continue with warnings. Extra asset directories can be appended with --resource-path (repeatable).

from pathlib import Path
from manuscripta.export.book import run_export
from manuscripta import ManuscriptaImageError, ManuscriptaLayoutError

try:
    run_export(
        Path("/abs/path/to/my-book"),  # REQUIRED — no cwd fallback
        formats="pdf",
        resource_paths=[Path("/abs/shared/assets")],
        strict_images=True,            # default
    )
except ManuscriptaLayoutError as e:
    print(f"Bad project layout: missing {e.missing}")
except ManuscriptaImageError as e:
    print(f"Unresolved images: {e.unresolved}")

source_dir must contain manuscript/, config/, and assets/ — a ManuscriptaLayoutError is raised otherwise, naming the missing pieces.

Migrating from v0.7.x? See MIGRATION.md.

Controls output formats, TOC behavior, and section ordering per book type (ebook, paperback, hardcover, audiobook).

TTS configuration: language, voice, and sections to skip during audio generation.

Pandoc metadata: title, author, date, language.

All export commands have a -safe variant (e.g. export-pdf-safe) that skips source preprocessing for fast, non-destructive draft builds.

manuscripta/
  export/        # PDF, EPUB, DOCX, HTML, Markdown export
  audiobook/     # TTS-based audiobook generation
    tts/         # Pluggable TTS backends (Edge, gTTS, pyttsx3, ElevenLabs)
  translation/   # DeepL and LMStudio translation
  markdown/      # Markdown processing (quotes, links, emojis, TOC)
  paths/         # Path conversion (absolute/relative, image tags)
  images/        # Image conversion, generation, injection
  project/       # Project init, chapters, metadata, tagging
  config/        # Config file loading
  enums/         # Book type enum
  utils/         # Pandoc batch, git cache, bulk operations
  data/          # Emoji/symbol maps, JSON data files

git clone https://github.com/astrapi69/manuscripta.git
cd manuscripta
make lock-install

Run make help for a full list. Key targets:

# All tests with coverage
make test

# Quick run without coverage
make test-fast

# Full CI check before committing
make ci

# Test release
make publish-test

# Production release
make publish

Both targets run the full CI pipeline (lint, format-check, tests) before building and publishing.

• manuscript-tools - Validation, sanitization and metrics for Markdown manuscripts. Install separately for linting capabilities.

MIT