book-converter

Convert EPUB books into formatted Markdown with pandoc and AI-assisted refinement.

14|3|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/bmad-labs/skills --skill book-converter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: book-converter
Source: https://github.com/bmad-labs/skills/tree/main/skills/book-converter
Command: npx skills add https://github.com/bmad-labs/skills --skill book-converter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the complex and time-consuming process of converting EPUB books into high-quality, professionally formatted Markdown, preserving content integrity and improving readability.

Core Features & Use Cases

  • EPUB to Markdown Conversion: Extracts raw Markdown from EPUB files using pandoc.
  • AI-Assisted Formatting: Employs subagents to fix common conversion artifacts like split paragraphs, code block issues, and header inconsistencies.
  • Structured Output: Generates chapter-by-chapter Markdown files and a final merged book with a Table of Contents.
  • Use Case: Convert a technical manual or novel from EPUB to Markdown for easier editing, integration into documentation systems, or use with AI models.

Quick Start

Convert the EPUB file located at '/Users/username/Downloads/MyBook.epub' into a formatted Markdown book.

Frequently Asked Questions about book-converter

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

FAQPage Schema
How do I convert an EPUB to Markdown without broken paragraphs and formatting artifacts?

You can convert an EPUB to Markdown by using pandoc for initial extraction and AI subagents to fix broken paragraphs, correct code blocks, and standardize headers, ensuring a polished and readable final document.

What is the best way to fix split paragraphs when converting EPUB files?

The best way to fix split paragraphs during EPUB conversion is to use AI-assisted subagents that automatically detect and join fragmented text blocks, standardize headers, and correct formatting artifacts for clean Markdown output.

Does EPUB to Markdown conversion automatically generate a Table of Contents?

Yes, EPUB to Markdown conversion can automatically generate a Table of Contents. The process creates chapter-by-chapter Markdown files and merges them into a final book complete with a structured Table of Contents.

Can I use pandoc alone for high-quality EPUB to Markdown conversion?

Using pandoc alone for EPUB to Markdown conversion provides raw extraction but often leaves artifacts, split paragraphs, and inconsistent headers, requiring additional AI-driven formatting to achieve professional quality.

How do I convert a technical manual from EPUB to Markdown for documentation systems?

To convert a technical manual from EPUB to Markdown for documentation systems, use an automated workflow that extracts content with pandoc and employs AI subagents to correct code blocks and standardize headers for clean integration.