markdown-to-epub-converter

Convert Markdown content into EPUB3 ebooks with chapters and table of contents.

9|2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/hongmaple0820/agent-academy --skill markdown-to-epub-converter-hongmaple0820
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-to-epub-converter
Source: https://github.com/hongmaple0820/agent-academy/tree/main/skills/documentation/markdown-to-epub
Command: npx skills add https://github.com/hongmaple0820/agent-academy --skill markdown-to-epub-converter-hongmaple0820

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ebooklib, pygments, and includes scripts (resource) components.

What problem does it solve?

Converts Markdown documents into formatted EPUB ebooks, enabling portable distribution of content created in Markdown.

Core Features & Use Cases

  • Automatic EPUB3 generation from Markdown, deriving chapters from H1 headers and sections from H2-H6
  • YAML frontmatter support for metadata, CSS styling, and embedded code blocks and tables
  • Use cases include converting blog posts, technical reports, notes, and chat transcripts into ready-to-distribute ebooks

Quick Start

Provide Markdown content and receive a downloadable EPUB file.

Frequently Asked Questions about markdown-to-epub-converter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert markdown files to an EPUB ebook with a table of contents?

To convert markdown to an EPUB ebook, provide the markdown content and the tool parses H1 headers into chapters and H2-H6 into sections, automatically generating a navigable table of contents for portable reading.

Can I use YAML frontmatter to set metadata when converting markdown to EPUB?

Yes, you can use YAML frontmatter to set metadata when converting markdown to EPUB. The converter parses frontmatter to define ebook metadata and applies CSS styling for the final output.

Does converting markdown to EPUB preserve code blocks and tables?

Converting markdown to EPUB preserves code blocks and tables. The output standards-compliant EPUB3 file retains these markdown features using pygments for code syntax highlighting.

What is the best way to turn blog posts and chat transcripts into an ebook?

The best way to turn blog posts and chat transcripts into an ebook is converting markdown to EPUB. This process organizes scattered content into structured chapters and sections for ready-to-distribute reading.

Do I need to manually separate chapters when converting markdown to EPUB?

No, you do not need to manually separate chapters when converting markdown to EPUB. The converter automatically derives chapters from H1 headers and sections from H2-H6 headers.

What markdown features are supported when generating an EPUB3 file?

When generating an EPUB3 file from markdown, supported features include code blocks, tables, and YAML frontmatter for metadata, ensuring standards-compliant output for portable distribution.