Labsco
smerchek logo

Markdown to EPUB

β˜… 133

by smerchek Β· part of smerchek/claude-epub-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.

πŸ”₯πŸ”₯πŸ”₯βœ“ VerifiedFreeQuick setup
🧩 One of 3 skills in the smerchek/claude-epub-skill package β€” works on its own, and pairs well with its siblings.

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.

Inspect the full instructions your agent will receiveExpand

This is the exact playbook injected into your agent when the skill activates β€” shown here so you can audit it before installing. You don't need to read it to use the skill.

by smerchek

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. npx skills add https://github.com/smerchek/claude-epub-skill --skill markdown-to-epub-converter Download ZIPGitHub133

Markdown to EPUB Converter Skill

This skill transforms markdown documents into professional EPUB ebook files. Perfect for converting research documents, blog posts, articles, or chat conversation summaries into portable, device-agnostic ebook formats.

Overview

The skill accepts markdown content in multiple formats and generates a properly formatted EPUB3 file that works across all major ebook readers including:

  • Apple Books

  • Amazon Kindle (via Kindle for Mac/Windows/iOS/Android)

  • Google Play Books

  • Kobo and other EPUB readers

  • Any standard EPUB reader

Input Formats

Option 1: Raw Markdown Text

Provide markdown content directly in your message:

Copy & paste β€” that's it
Convert this markdown to EPUB:
# My Book Title

## Chapter 1

This is chapter one content...

Option 2: File Path

Provide a path to a markdown file to be converted.

How It Works

Markdown Parsing: Analyzes your markdown and automatically:

  • Treats H1 headers (#) as chapter boundaries

  • Treats H2 headers (##) as section headings within chapters

  • Preserves formatting (bold, italic, links, lists, code blocks)

Structure Generation: Creates proper EPUB structure:

  • Automatic table of contents from chapters

  • Navigation document (EPUB3 standard)

  • Metadata (title, language, etc.)

File Creation: Generates a valid EPUB3 file ready for download and use

How to Build a Simple Web Server

Introduction

...content..."

Example 2: Convert a Research Summary

"I have research notes in markdown format. Convert them to an EPUB ebook. The content is:

Research Project: Machine Learning Basics

Chapter 1: Fundamentals

..."

Example 3: Convert a Chat Summary

"Summarize our conversation so far as markdown and convert it to an EPUB for reference"

Output

The skill generates a downloadable EPUB file that includes:

  • Professional formatting

  • Automatic table of contents

  • Proper chapter structure

  • Support for markdown formatting elements:

  • Headers (all levels)

  • Bold and italic text

  • Hyperlinks

  • Lists (ordered and unordered)

  • Code blocks and inline code

  • Blockquotes

  • Horizontal rules

Markdown Elements Supported

Element Markdown Support Notes Headers # H1 through ###### H6 Full Auto TOC generation Bold **text** or __text__ Full Italic *text* or _text_ Full Links [text](url) Full Clickable in ebooks Lists - item or 1. item Full Nested lists supported Code blocks ````language**Enhanced** Syntax highlighting ready, monospace fonts Inline code code **Enhanced** Styled background, borders Tables Markdown tables **Enhanced** Styled headers, alternating rows Blockquotes> quoteFull Styled with left border Horizontal rule---or***` Full

Advanced Features

Enhanced Code Block Support

Code blocks are beautifully formatted with:

  • Premium monospace fonts: SF Mono, Monaco, Fira Code, Consolas, and more

  • Styled backgrounds: Subtle gray background with blue accent border

  • Language detection: Specify language after ````` for future syntax highlighting

  • Proper escaping: HTML characters are safely escaped

  • Overflow handling: Horizontal scrolling for long lines

Example:

Copy & paste β€” that's it
def fibonacci(n):
 if n Tables are rendered with professional styling:

 

- **Styled headers**: Blue background with white text 

- **Alternating rows**: Zebra striping for readability 

- **Cell padding**: Comfortable spacing for easy reading 

- **Inline formatting**: Code, bold, italic, and links work in cells 

- **Responsive**: Tables adapt to different screen sizes 

 Example:

 Feature Status Notes 
 Headers βœ“ Full support 
 Code βœ“ Enhanced styling 
 Tables βœ“ Professional layout 
 

### Custom Title and Metadata

 You can specify EPUB metadata:

 

- Book title (defaults to first H1 header) 

- Author name 

- Language 

- Publication date 

### Chapter Organization

 Chapters are automatically detected from:

 

- H1 headers (`#`) as primary chapter breaks 

- Logical content sections between H1s 

- Automatic page breaks between chapters 

### Styling

 The generated EPUB uses clean, readable default styling that:

 

- Respects the reader's font preferences 

- Works on all screen sizes 

- Maintains proper spacing and hierarchy 

- Includes appropriate margins and padding

## Technical Details

- **Format**: EPUB3 (compatible with all modern readers) 

- **Encoding**: UTF-8 

- **HTML Version**: XHTML 1.1 

- **CSS Support**: Responsive styling

## Downloading Your EPUB

After generation, the file will be available for download. You can then:

 

- Download the EPUB to your computer 

- Open it with your preferred ebook reader 

- Transfer to your Kindle, iPad, or other device 

- Upload directly to Kindle via email or cloud

## Tips for Best Results

- 
 **Use Proper Markdown Structure**: The skill works best when markdown follows standard conventions (H1 for titles, H2 for sections)

 

- 
 **Clear Chapter Breaks**: Use H1 headers to clearly mark chapter divisions

 

- 
 **Descriptive Headers**: Headers become the table of contents, so make them clear and descriptive

 

- 
 **Content Organization**: Place content logically between headers

 

- 
 **Supported Formatting**: Stick to basic markdown formatting for best compatibility across all readers

## Scripts

- `epub_generator.py` - Core EPUB file creation and formatting 

- `markdown_processor.py` - Markdown parsing and structure extraction

## Future Enhancements

- Auto-generated cover pages with custom images 

- Kindle-specific optimizations (.mobi format) 

- Custom CSS styling per user preferences 

- Multi-document merging 

- Image embedding and optimization 

- Advanced metadata support

## Related Skills

changelog-writing
 langfuse

 

 Use this skill when a completed feature branch needs a changelog entry.
 official 

 
 build-zoom-rest-api-app
 anthropic

 

 Reference skill for Zoom REST API. Use after choosing an API-based workflow when you need endpoint selection, resource-management patterns, OAuth requirements,…
 official 

 
 improve
 shadcn

 

 Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code β€” never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to...
 development code-review research 

 
 winmd-api-search
 github

 

 Search and explore Windows desktop APIs with full type signatures and members. Indexes Windows Platform SDK, WinAppSDK, NuGet packages, and project-output WinMD files; Platform SDK and WinAppSDK are available immediately on fresh clones without restore or build Two workflows: discover mode for finding the right API by capability keywords, and lookup mode for retrieving exact methods, properties, events, and enum values of known types Requires .NET SDK 8.0+ and a one-time cache generation via...
 official 

 
 gws-gmail-reply-all
 Google

 

 Gmail: Reply-all to a message (handles threading automatically).

 
 wp-block-development
 wordpress

 

 WordPress block development for Gutenberg: metadata, registration, rendering, and build workflows. Covers block creation, block.json configuration, static vs. dynamic rendering, and server-side PHP registration with register_block_type_from_metadata() Enforces apiVersion: 3 for WordPress 6.9+ compatibility, including iframe editor support and style isolation Handles attribute serialization, deprecations/migrations to prevent "Invalid block" errors, and inner blocks composition Includes...
 official 

 
 recruiting-pipeline
 anthropic

 

 Track and manage recruiting pipeline stages. Trigger with "recruiting update", "candidate pipeline", "how many candidates", "hiring status", or when the user…
 official 

 
 langgraph-docs
 langchain-ai

 

 Use this skill for requests related to LangGraph in order to fetch relevant documentation to provide accurate, up-to-date guidance.
 official