markdown-to-epub

Converts Markdown manuscripts with local images into EPUB files via ebook-convert.

Updated Feb 23, 2026
One-click install
npx skills add https://github.com/zphwd/bianchengbaodian --skill markdown-to-epub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-to-epub
Source: https://github.com/zphwd/bianchengbaodian/tree/main/skills/markdown-to-epub
Command: npx skills add https://github.com/zphwd/bianchengbaodian --skill markdown-to-epub

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the conversion of Markdown documents, including local image assets, into well-structured and verifiable EPUB files, streamlining the publishing workflow.

Core Features & Use Cases

  • EPUB Generation: Converts Markdown manuscripts into EPUB format.
  • Image Normalization: Fixes and unifies local image references and extensions.
  • Structure Validation: Performs basic checks on the EPUB package structure.
  • Use Case: Convert a series of Markdown notes into a single, shareable EPUB ebook, ensuring all embedded images are correctly referenced and included.

Quick Start

Use the markdown-to-epub skill to convert the file './book.md' into './book.epub' with the title 'Book Title' and author 'Author Name'.

Frequently Asked Questions about markdown-to-epub

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

FAQPage Schema
How do I convert Markdown to EPUB with local images?

Markdown to EPUB conversion normalizes local image references and extensions, then generates a verifiable EPUB file using Calibre's ebook-convert tool.

Does converting Markdown to EPUB require Calibre?

Yes, generating an EPUB from Markdown requires Calibre's ebook-convert utility to execute the actual conversion process and package the manuscript.

How does Markdown to EPUB conversion handle the table of contents?

Markdown to EPUB conversion maintains the table of contents automatically by utilizing the existing heading hierarchy within your Markdown manuscript.

Can I validate EPUB package structure when converting from Markdown?

Yes, converting Markdown to EPUB performs basic EPUB package structure validation to ensure the generated ebook file is correctly formatted and verifiable.

What is the best way to fix image references when publishing an ebook from Markdown?

Markdown to EPUB conversion normalizes and unifies local image references and extensions during the publishing workflow, ensuring all embedded images are correctly included.