Does this skill require external software?

Yes, this skill relies on Pandoc to perform the initial raw extraction from EPUB to Markdown before the AI-assisted formatting begins.

Can it fix code blocks that were broken during conversion?

Yes, one of the primary features is its ability to identify and merge 'shattered' code blocks, adding proper language identifiers and ensuring syntactic completeness.

What happens to the images inside the EPUB?

The skill extracts images into a dedicated project folder and updates the Markdown links with descriptive alt text and correct relative paths.

Is the formatting style customizable?

Yes, the conversion process follows a formatting-standards.md file which can be modified to match your specific style guides or project requirements.

How does it handle very large books?

It utilizes a subagent architecture that processes chapters in parallel. This prevents context window issues and ensures that each section receives focused, high-quality attention.

Professional Book to Markdown Converter

Name: Professional Book to Markdown Converter
Author: bmad-labs

bybmad-labs

•

Learning & Documentation

Converts EPUB files into high-quality, professionally formatted Markdown documents using AI-assisted cleanup and structural refinement.

This skill streamlines the conversion of EPUB ebooks into clean, production-ready Markdown by combining the power of Pandoc with sophisticated AI-driven formatting. It goes beyond simple file conversion by utilizing specialized subagents to resolve common conversion artifacts such as shattered code blocks, split paragraphs, and inconsistent headers. By following a rigorous multi-pass workflow, the skill ensures that technical books maintain their structural integrity, code accuracy, and professional aesthetic, resulting in a perfectly formatted single-file Markdown output complete with an automated Table of Contents.

Key Features

01Automated EPUB extraction and project directory organization

02Seamless merging of formatted chapters into a single file with a generated TOC

03Parallel chapter processing using isolated subagents for high efficiency

04AI-driven structure analysis and automated chapter boundary mapping

05Multi-pass formatting to fix broken code blocks and text flow artifacts

061 GitHub stars

Use Cases

01Preparing ebook content for publishing on documentation platforms, wikis, or GitHub repositories

02Cleaning up low-quality PDF-to-EPUB conversions that suffer from broken paragraphs and corrupted formatting

03Converting technical EPUB books into clean Markdown for personal knowledge bases or Obsidian

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bmad-labs/skills book-converter

For use in Claude.ai and ChatGPT

Download Skill