Última actualización: 11 de noviembre de 2026
La forma más rápida de convertir Markdown a EPUB es Pandoc: ejecuta pandoc book.md -o book.epub y obtendrás un EPUB válido. Si no quieres instalar nada, sube el archivo .md a un conversor web como Convert2EPUB. En ambos casos, la calidad del ebook depende sobre todo de cómo estructures los encabezados y los metadatos antes de convertir.
¿Qué necesitas para convertir un archivo Markdown a EPUB?
Necesitas un archivo Markdown con una estructura de encabezados clara, un título y un autor, y una herramienta que genere EPUB. Pandoc es la herramienta de línea de comandos de referencia. Un conversor en el navegador hace lo mismo sin instalar nada.
Antes de convertir, asegúrate de que el origen está listo:
- Un encabezado
#por capítulo. Según la guía de usuario de Pandoc, Pandoc divide un EPUB en capítulos en los encabezados de nivel 1 de forma predeterminada. Si escribes los capítulos como##, cámbialo o ajusta el nivel de división (lo vemos más abajo). - El título y el autor en un bloque de metadatos al principio del archivo, no solo en un encabezado.
- Imágenes con rutas relativas que se resuelvan desde donde ejecutas el comando, y con texto alternativo.
- Nada de HTML sin procesar del que no puedas prescindir. Las etiquetas sencillas suelen sobrevivir, pero los scripts, los iframes y los trucos de CSS no tienen sitio en un archivo para e-reader.
¿Cómo convierto Markdown a EPUB con Pandoc?
Instala Pandoc, pon un bloque de metadatos YAML al principio del archivo y ejecuta un solo comando. Pandoc crea el índice a partir de tus encabezados.
1. Añade los metadatos
Pandoc lee los metadatos del EPUB de un bloque YAML dentro del archivo Markdown, o de un archivo YAML aparte, como describe el manual de Pandoc. Un bloque mínimo:
---
title: The Lighthouse Letters
author: Dana Whitfield
lang: en-GB
date: 2026-11-11
cover-image: cover.jpg
---
lang importa más de lo que parece. Controla la división de palabras y la lectura en voz alta en algunos lectores. La fecha la eliges tú, así que pon la fecha de publicación que quieras mostrar.
2. Ejecuta el comando
pandoc book.md -o book.epub --toc --toc-depth=2
--toc-depthfija cuántos niveles de encabezado aparecen en el índice. Según el manual de Pandoc, el valor predeterminado es 3, así que se listan los niveles 1, 2 y 3. Para una novela,1o2suele quedar más limpio.--epub-cover-image=cover.jpghace lo mismo que el campocover-image. Pandoc recomienda una portada de menos de 1000px de ancho y de alto.--epub-title-page=falsequita la página de título que se genera si ya has escrito la tuya.
3. Combina varios archivos
Muchos autores tienen un archivo por capítulo. Pásalos en orden y Pandoc los une:
pandoc 01-intro.md 02-first-night.md 03-storm.md -o book.epub
Pon números al principio de los nombres de archivo para que el orden del shell coincida con el orden de lectura. Pon el bloque de metadatos solo en el primer archivo.
4. Dale estilo, con moderación
Pandoc aplica una hoja de estilos predeterminada. Para cambiarla, pasa --css=epub.css. Mantén el CSS al mínimo: define la sangría de los párrafos y los márgenes de los encabezados, y no toques la familia ni el tamaño de letra. Los lectores de ebooks dejan que cada persona elija ambas cosas, y si las sobrescribes, se pierde ese control.
¿Cómo estructuro los encabezados para que los capítulos y el índice salgan bien?
Usa # para los capítulos y ## para las secciones dentro de ellos, y no te saltes niveles. El menú de navegación del EPUB se genera a partir de estos encabezados, así que la estructura que escribes es la estructura que recibe el lector.
| Tu Markdown | Qué pasa en el EPUB (valores predeterminados de Pandoc) |
|---|---|
# Chapter | Empieza un nuevo archivo de capítulo y aparece en el índice |
## Section | Aparece en el índice (profundidad 3 por defecto), pero se queda dentro del archivo del capítulo |
### Subsection | Aparece en el índice solo si la profundidad lo permite |
| Texto en negrita con aspecto de encabezado | No es un encabezado; no aparecerá en el índice |
Dos problemas habituales:
- Un libro con un solo encabezado
#. Todo el libro se convierte en un único archivo grande. El manual de Pandoc señala que esta opción solo afecta a la composición interna del EPUB, no a cómo se le muestran los capítulos al lector, y que algunos e-readers pueden ir lentos con archivos de capítulo muy grandes. Para un documento largo con pocos encabezados de primer nivel, usa--split-level=2o3. - Un título escrito como
#y los capítulos también como#. El título aparece entonces como un capítulo más. Pon el título en el bloque YAML y reserva#para los capítulos de verdad.
Si después el índice sigue viéndose mal, nuestra guía para arreglar un índice de EPUB que falta o está roto repasa las comprobaciones.
¿Se puede convertir Markdown a EPUB sin instalar Pandoc?
Sí. Un conversor web que acepte archivos .md te deja subir el archivo, indicar el título y el autor y descargar el EPUB. Va bien para conversiones puntuales y para quien no quiere usar la línea de comandos.
Así se comparan los dos enfoques:
| Pandoc | Conversor en el navegador | |
|---|---|---|
| Hay que instalarlo | Sí | No |
| Repetible en un script de compilación o en CI | Sí | No |
| CSS, fuentes y filtros propios | Control total | Limitado a los ajustes de la herramienta |
| Unir varios archivos | Sí, listándolos | Hay que combinarlos antes en uno solo |
| Ideal para | Libros que regeneras a menudo | Conversiones rápidas y ocasionales |
El cuadro de subida de Convert2EPUB incluye Markdown entre los formatos aceptados, con un límite de 100 MB. Tiene ajustes para el título, el autor, el formato adaptable o de diseño fijo y el dispositivo de destino. Su modelo Standard gratuito se describe en el sitio como adecuado para diseños sencillos, como las novelas, que es también lo que son la mayoría de los manuscritos en Markdown. Si no tienes claro si el formato adaptable es la opción correcta, consulta nuestra comparativa de EPUB adaptable y de diseño fijo. Para prosa, lo es.
¿Qué debo comprobar antes de enviar el EPUB a un e-reader?
Abre el archivo en al menos una aplicación de lectura real y repasa una lista breve. La mayoría de los problemas de Markdown a EPUB se ven en los primeros cinco minutos.
- Índice: abre el menú de navegación. Deben estar todos los capítulos, en orden y con nombres razonables.
- Portada y título: la portada debe verse en la vista de biblioteca, y el título y el autor deben aparecer correctamente.
- Imágenes: comprueba que cada imagen aparece, se ajusta a la pantalla y no tiene bordes sueltos.
- Bloques de código y tablas: las líneas largas de los bloques de código pueden salirse de la pantalla en los lectores pequeños. Pártelas o acórtalas. Para una pantalla de 6 pulgadas, es mejor reescribir las tablas anchas como listas.
- Notas al pie: Pandoc convierte las notas al pie de Markdown en notas enlazadas. Toca una y comprueba que te devuelve al texto.
- Validación: si piensas publicar en una tienda, pasa el archivo por EPUBCheck, el validador respaldado por el W3C que suelen usar las tiendas. Detecta problemas que los lectores pasan por alto sin avisar.
Para pantallas e-ink pequeñas, nuestro artículo sobre ajustes de EPUB para un lector e-ink de 6 pulgadas explica qué configurar en el archivo y qué configurar en el dispositivo.
Si prefieres saltarte la configuración, puedes subir tu archivo .md a Convert2EPUB y descargar un EPUB adaptable.
¿Puedo leer en un Kindle un EPUB hecho con Markdown?
Sí. Envía el EPUB a tu Kindle por correo electrónico o con la aplicación Send to Kindle, y no tendrás que convertirlo a MOBI ni a AZW3. La propia página de Convert2EPUB dice que Send to Kindle acepta un EPUB tal cual. Nuestra guía para enviar un EPUB a tu Kindle explica los pasos.
Preguntas frecuentes
¿Puede Pandoc convertir Markdown directamente a MOBI o AZW3?
No. Pandoc genera EPUB, no MOBI ni AZW3. Los flujos de trabajo actuales de Kindle aceptan EPUB directamente, así que una conversión aparte no suele hacer falta. Solo los Kindle muy antiguos necesitan MOBI.
¿Por qué mi EPUB es un único capítulo gigante?
Pandoc divide los capítulos en los encabezados de nivel 1 de forma predeterminada. Si tu Markdown tiene un solo # o ninguno, todo acaba en un único archivo. Cambia los encabezados de capítulo a #, o usa --split-level=2.
¿Cómo añado una imagen de portada?
Añade cover-image: cover.jpg al bloque YAML, o pasa --epub-cover-image=cover.jpg. El manual de Pandoc recomienda una imagen de menos de 1000px de ancho y de alto. Mantén la ruta relativa al lugar desde donde ejecutas el comando.
¿Se conserva el formato de Markdown, como la negrita, las listas y las citas en bloque?
Sí. Los elementos estándar de Markdown se convierten en sus equivalentes HTML dentro del EPUB, y el estilo propio del lector los muestra. Las extensiones varían según la herramienta, así que comprueba en el resultado la sintaxis poco habitual, como las listas de definiciones o las listas de tareas.
¿Puedo convertir una carpeta entera de archivos Markdown?
Con Pandoc, sí. Lista los archivos en orden o usa un comodín como *.md, como hace un tutorial de DEV Community con un repositorio de documentación. Numera los nombres de archivo para que el orden sea predecible.
¿Listo para convertir tu propio PDF? Es gratis para documentos de texto normales, sin necesidad de cuenta.
Convertir un PDF a EPUB →