Markdown to EPUB Converter

Markdown to EPUB Claude Skill

A Claude agent skill that converts markdown documents and chat summaries into professional EPUB ebook files. Perfect for creating portable, device-agnostic ebooks from research documents, blog posts, articles, or conversation summaries.

Overview

This skill transforms markdown content into EPUB3 format ebooks that work across all major reading platforms:

• Apple Books
• Amazon Kindle (via Kindle reading apps)
• Google Play Books
• Kobo
• Any standard EPUB reader

Features

✨ **Markdown Processing**

• Automatic chapter detection from H1 headers
• Automatic section parsing from H2-H6 headers
• Full markdown formatting support (bold, italic, links, lists, code blocks, etc.)
• Enhanced code blocks with premium monospace fonts and syntax highlighting support
• Professional tables with styled headers and alternating row colors

📚 **EPUB Generation**

• EPUB3 standard compliance
• Automatic table of contents with proper navigation
• Responsive, device-agnostic styling
• Proper document structure and metadata
• Beautiful code formatting for technical documents

🎯 **Smart Input Handling**

• Accept raw markdown text directly
• Process markdown files by path
• Extract metadata from YAML frontmatter
• Handle edge cases gracefully

Project Structure

markdown-to-epub/
├── SKILL.md                    # Skill definition with YAML frontmatter
├── requirements.txt            # Python dependencies
├── scripts/
│   ├── markdown_processor.py  # Markdown parsing & structure extraction
│   ├── epub_generator.py      # EPUB file creation & formatting
└── resources/
    └── default_styles.css     # (future) Custom EPUB styling
test_epub_skill.py             # Test suite with sample content

Installation

Prerequisites

• Python 3.8+
• pip (Python package manager)

Setup

1. **Install dependencies:**

   pip install -r markdown-to-epub/requirements.txt

2. **Verify installation:**

...