Markdown to EPUB

Markdown to EPUB

Convert markdown documents into professional EPUB ebook files with proper formatting and metadata.

Claude / Claude Code
GitHub Copilot
Cursor
VS Code
OpenAI Codex
Document CreationDeveloperTeacher / EducatorResearcher

What it does

EPUB is a structured XML format with specific metadata requirements, navigation document conventions, and a packaging step that produces the final .epub file. Claude can generate the component files but frequently gets the OPF manifest wrong, misses the NCX navigation document for older readers, or produces EPUBs that fail validation and won't load on Kindle or iBooks. This skill loads the complete EPUB 3 specification workflow: correct content document structure, proper OPF manifest generation, spine ordering, and the packaging step that produces a valid, validated file. Made by smerchek.

Use case

Converting written content (blog posts, documentation, short fiction, technical guides) into EPUB format for distribution as ebooks. Essential when the output needs to pass EPUB validation rather than just have a .epub extension.

The Prompt

Copy and use immediately
"Convert this markdown document into a properly formatted EPUB ebook."
"Create an EPUB from these 10 markdown chapters with a table of contents."
"Convert my blog post series into an EPUB with correct metadata."
"This EPUB fails validation on Kindle — diagnose and fix the structure."
"Generate an EPUB with custom CSS for the chapter headings."

How to use

  1. 1

    Provide the markdown content — single file or multiple files for multi-chapter books.

  2. 2

    Specify metadata: title, author, language, ISBN if applicable.

  3. 3

    Claude produces a valid EPUB 3 file that passes epubcheck validation.

Input / Output

Input

Markdown content (one or more files), book metadata (title, author, language), and any styling requirements.

Output

A valid EPUB 3 file with correct OPF manifest, navigation document, properly structured content files, and embedded CSS. Passes epubcheck validation and loads correctly in Kindle, iBooks, and Kobo.

Added 15 Mar 2026Submitted by smerchek👁 43📋 0

Details

Platforms
Claude / Claude CodeGitHub CopilotCursorVS CodeOpenAI Codex
Category
Document Creation
License
apache-2.0
Author
smerchek

Stats

📋 Copies0
👁 Views43
👍 Upvotes0

Install with skills.sh

npx skillsadd smerchek/skills/markdown-to-epub

Requires skills.sh CLI

Community Notes

Sign in with GitHub to leave a note.

No notes yet. Be the first to contribute.