# Md To Epub

> Convert Markdown to EPUB 3 e-books via Pandoc.

- Skill: `gabrielmoreira/md-to-epub` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/md-to-epub`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/md-to-epub/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/md-to-epub

---


# md-to-epub

Convert Markdown to EPUB 3 e-books via Pandoc.

## When to Use

- Long-form documents distributed as e-books
- Multi-chapter content with embedded images
- Documents needing TOC, cover, and reflowable text

## What's Here

`md-to-epub.cjs` — Node script that wraps Pandoc.

## External Dependencies

- `node` (≥ 16)
- `pandoc` (≥ 3.0) on PATH

## Usage

```bash
node md-to-epub.cjs input.md
node md-to-epub.cjs input.md --output book.epub
node md-to-epub.cjs input.md --cover cover.png
```

## Frontmatter Hooks

```yaml
---
title: My Book
author: Your Name
publisher: Press Name
language: en
cover-image: cover.png
toc: true
---
```

## Notes

- Mermaid diagrams pre-rendered to PNG and embedded
- Each H1 becomes a chapter; H2 subsections
- Validate with epubcheck before distribution