markdown-to-epublisted

Convert one or more Markdown files into a clickable, text-to-speech-friendly EPUB for e-readers (Kindle), with an optional branded cover. Use when the user wants an EPUB or ebook from markdown, a briefing or research note as EPUB, or wants to aggregate several markdown artifacts into a single self-contained topical EPUB "book" with an intro and a table of contents (common after a long session or deep research that produced many markdown files that are painful to jump between in a chat UI, and that the user wants to read or listen to on the go). Preserves clickable links, including timestamped video deep-links, and generates a navigable table of contents. Triggers: "make an epub", "turn this into an ebook", "epub for kindle", "convert this briefing to epub", "bundle these markdowns into a book", "combine these notes into one ebook", "make me an ebook of the artifacts you just created".
dzivkovi/claude-skills · ★ 0 · Data & Documents · score 65

Install: claude install-skill dzivkovi/claude-skills

# markdown-to-epub Turn Markdown into a clickable + listenable EPUB, optionally with a branded cover. The engine is `pandoc`; this skill is the recipe, one stylesheet, and a cover generator. Keep the conversion itself scriptless (see "Do not build"). ## Why EPUB It keeps links clickable (including `...&t=<seconds>` video deep-links) and is text-to-speech readable on Kindle. Print and PDF are neither. A cover image makes it show as a real book in the Kindle library instead of a blank placeholder. ## Step 0 - preflight the core dependency (pandoc) Pandoc is the ONE required dependency. Before converting, run: ```bash python "<SKILL_DIR>/scripts/setup/pandoc_preflight.py" ``` Exit 0 = ready. Exit 2 = missing: it prints the OS-specific install command (winget/choco/scoop, brew, apt/dnf/pacman) and https://pandoc.org/installing.html. Relay that and stop; do not auto-install a system package. (The cover step below additionally needs Pillow; the core conversion does not.) ## Convert from the Markdown SOURCE, never from PDF or DOCX Markdown holds the real links and headings. PDF->EPUB is lossy. If only a PDF/DOCX exists, convert THAT to markdown first (`pandoc in.docx -o in.md`) as a last resort. ## Branded cover (optional; default ON for briefings and shared reading books) Pandoc cannot compose a titled cover, so `scripts/make_cover.py` (Pillow) builds a portrait PNG: brand background + logo + title + subtitle + author + a DATE stamp (so multiple same-month versions are disting