Markdown in.
A designed book out.

An agent skill that turns one .md file into a PDF and EPUB with a real cover, real pagination, and three swappable themes. Tell your agent what book you want; review a finished PDF.

manuscript.md --- title: Field Notes author: You --- # Part One ## Chapter 1 ## Chapter 2 - [ ] checklist Field Notes A working guide YOUR PRESS Chapter 1 3 .pdf .epub
Install in 30 seconds
$ cp -R book-publisher ~/.claude/skills/

Unzip first, then run this. Open a new agent session and say "build me an ebook". Run scripts/check_deps.py once for pandoc + weasyprint install commands.

Everything a book needs, from plain Markdown

The design decisions are encoded in the skill, so your agent gets them right the first time.

01

Real book structure

# is a Part, ## is a Chapter, ### is a Section. Front matter sets title and author. You get a cover, TOC, roman-numeral front matter that restarts at Chapter 1, and running headers.

02

Three real themes

boardroom for lead magnets, tufte for academic essays with margin sidenotes, jianghu for novels with true footnotes. Each reproduces a reference design, not a generic default.

03

One flag to reskin

Switch themes with --theme tufte. The manuscript never changes. Build all three from the same file and pick your favorite.

04

Rich blocks, still Markdown

Checklists render as designed check boxes. Definition boxes highlight key terms. Sidenotes sit in the margin or become bottom-of-page footnotes, theme depending.

05

Print-ready duplex mode

--facing-pages mirrors margins between left and right pages and opens every chapter on a right-hand page, the way bound books do.

06

Built-in QA previews

Every build renders the first pages to PNG. Overflow, bad breaks, and cover bleed only show up rendered, so the skill makes your agent look before shipping.

How it works with your agent

You talk. The agent writes, builds, inspects, and fixes. You review a finished PDF.

1

Drop it in

Copy the folder into ~/.claude/skills/ or any agent's skill directory.

2

Ask for a book

"Turn my notes into a lead magnet PDF." The skill activates on its own.

3

Agent builds

It writes the manuscript, runs the build, and checks the preview pages.

4

You ship

A designed PDF and EPUB land in your output folder, ready to send.

Convert
Pandoc
Render
WeasyPrint
Glue
Python stdlib
Design
CSS Paged Media
Source
Markdown

Frequently Asked Questions

Everything you need to know about Book Publisher.

Book Publisher is an agent skill that turns a single Markdown manuscript into a designed PDF and EPUB book: full-bleed cover, table of contents, part and chapter openers, page numbers, running headers, sidenotes, and checklists, all from plain headings and front matter.

Unzip the package and run cp -R book-publisher ~/.claude/skills/ for all projects, or copy into your-repo/.claude/skills/ for one project. Open a new session and ask for a book; the skill activates automatically.

Just describe the book: "Write a 5-chapter beginner's guide to sourdough and build it as a book." The agent reads the skill, writes the manuscript, builds both formats, and inspects rendered previews before handing over. No commands needed from you.

Three: boardroom, a corporate lead-magnet look with a full-bleed cover; tufte, monochrome academic style with margin sidenotes; jianghu, a translated-novel look with digest trim and real footnotes. Switching is one flag, no manuscript changes.

No. The skill encodes the design decisions: chapter breaks, TOC nesting, front-matter numbering. You write ordinary Markdown. Design tokens are exposed as CSS custom properties only if you want to customize.

Two tools: pandoc and weasyprint. The bundled check_deps.py detects your OS and prints exact install commands (on macOS: brew install pandoc, uv tool install weasyprint). Everything else is Python standard library.

Yes. Add --facing-pages and margins mirror between left and right pages, and every chapter opens on a right-hand page, inserting a blank left page when needed. Without the flag you get screen-reading output.

Yes. Hand your agent the reference PDF or page and say "make a theme from this". The skill documents the process used for its own themes: sample real colors, read real fonts, translate to print CSS, plus the known pitfalls.

Level-1 heading is a Part, level-2 a Chapter, level-3 a Section. YAML front matter sets title, subtitle, author, publisher. A working example manuscript demonstrating every pattern is bundled to copy from.

No. Book Publisher runs entirely on your machine. Pandoc and WeasyPrint are local tools, the build script is offline Python, and your manuscript never leaves your computer. No server, no account, no telemetry.

Open an issue at github.com/blacklogos/book-publisher/issues for bugs and requests, or email bookpublisher@cc4.marketing for anything else. Both are read by a human.

questions, bugs, love letters

bookpublisher@cc4.marketing

Read by a human. Bugs travel faster via GitHub Issues.