kabuk-epub

The EPUB converter for Kabuk. Reads the spine in order, converts each chapter's XHTML, and returns one Markdown document.

Most people want kabuk-mcp, which already includes it. Install this one if you are embedding kabuk-core directly and want EPUB support.

Usage

import { convert, registerConverter } from "kabuk-core";
import { epubConverter } from "kabuk-epub";

registerConverter(epubConverter);

const result = await convert({ bytes, filename: "book.epub" });

Why it is a separate package

It did not have to be. It is split out because a plugin contract nobody has consumed from outside is a guess, and this package imports kabuk-core through its package entry only — never a deep path — which is exactly what an outside contributor gets.

Building it that way before 0.1.0 froze the Converter interface is the whole point of the package. If implementing a converter from outside the monorepo had needed something core did not export, this is where that would have surfaced. ResolvedConversionOptions and ConverterOutput are both named types today because of it.

License

Apache-2.0 · Blu Signal Labs