publication-converter

Converts markdown documents into EPUB3 ebooks with automatic table of contents.

39|1|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/qodex-ai/ai-agent-skills --skill publication-converter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: publication-converter
Source: https://github.com/qodex-ai/ai-agent-skills/tree/main/skills/publication-converter
Command: npx skills add https://github.com/qodex-ai/ai-agent-skills --skill publication-converter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ebooklib, markdown2, Pygments, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the conversion of markdown documents into professionally formatted EPUB ebook files, making content easily accessible across various reading devices.

Core Features & Use Cases

  • Markdown to EPUB Conversion: Transforms structured markdown into EPUB3 format.
  • Automatic TOC Generation: Creates a table of contents from H1 headers.
  • Preserves Formatting: Supports bold, italic, links, lists, code blocks, and tables.
  • Use Case: Convert a series of research notes written in markdown into a single, navigable ebook for easy offline reading or sharing.

Quick Start

Use the publication-converter skill to convert the provided markdown text into an EPUB file.

Frequently Asked Questions about publication-converter

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

FAQPage Schema
How do I convert markdown to EPUB format?

Markdown to EPUB conversion is handled by parsing markdown documents and generating EPUB3 files using Python scripts. It preserves formatting and creates an ebook ready for various reading devices.

Does the markdown to EPUB conversion support code blocks and tables?

Yes, markdown to EPUB conversion supports code blocks, tables, bold, italic, links, and lists. The process preserves these structural elements during the document formatting workflow.

Can I generate a table of contents automatically from markdown headers?

Yes, you can generate a table of contents automatically from H1 headers. The conversion process extracts these headers to build a navigable structure within the EPUB3 document.

Do I need Python to parse markdown and generate an EPUB ebook?

Yes, you need Python to run the scripts required for parsing markdown and generating the EPUB. The conversion relies on specific Python libraries like ebooklib and markdown2.

What is the best way to turn research notes into an offline ebook?

The best way to turn research notes into an offline ebook is converting markdown to EPUB3. This transforms structured notes into a navigable file for easy offline reading and sharing.