Validación de libros electrónicos en formato ePub: EpubCheck

▶

Si ya sabes como generar tus propios epubs personalizados, el siguiente paso es que debes de verificar los mismos, los archivos generados no tengan errores. Para eso empleé la siguiente herramienta: EpubCheck, de la organización W3C, que maneja todos los estándares relacionados con EPUBs:

https://www.w3.org/publishing/epubcheck/

Validar EPUBs no es un trámite opcional ni un capricho técnico: es lo que marca la diferencia entre un ebook que “parece funcionar” y uno que realmente cumple los estándares y será aceptado sin problemas por plataformas como Google Play Books o Apple Books.

En esta guía te explico cómo validar EPUBs de forma profesional, qué herramientas usar y qué errores son los más comunes, basándome tanto en estándares oficiales como en problemas reales que me encontré por no validar a tiempo.

Qué significa validar un EPUB y por qué es obligatorio

Validar un EPUB significa comprobar que el archivo cumple los estándares técnicos del formato, no solo que se vea “bien” en un lector concreto.

EPUB que abre vs EPUB válido

Uno de los mayores errores es confundir estos dos conceptos. Un EPUB puede:

• Abrirse sin problemas en Calibre
• Verse correctamente en un lector concreto

…y aun así ser inválido.

En mi caso, esto lo descubrí cuando intenté subir un libro a Google Play Books. El EPUB se abría perfectamente, pero la plataforma devolvía errores y sugería contactar con soporte. El problema no era el contenido, sino la estructura interna del archivo.

Plataformas que exigen validación

Si publicas en:

• Google Play Books
• Apple Books
• Tiendas profesionales de ebooks

La validación no es negociable. Estas plataformas analizan el EPUB internamente y rechazan archivos con errores, aunque visualmente parezcan correctos.

¿Por qué es importante validar?

Realmente no sabía que esta parte de la generación de EPUBs era tan importante. Resulta que, además de asegurarte de que tu libro se vea bien en aplicaciones como Calibre, también tiene que ser válido estructuralmente, especialmente si lo vas a subir a plataformas como Google Play Books o Apple Books.

En mi caso, tuve problemas con el EPUB al subirlo a Google Play me arrojaba errores y sugería contactar con soporte. Todo esto lo descubrí precisamente porque no estaba validando correctamente los archivos EPUB.

Una herramienta profesional: EpubCheck (W3C)

Por eso decidí usar EpubCheck, una herramienta muy confiable que valida si el archivo cumple con los estándares. Aunque un EPUB se abra en Calibre, eso no significa que sea válido. Algunos errores pueden impedir que funcione correctamente en otras plataformas, o incluso que no se acepte la carga.

Además, como profesional, es importante hacer las cosas bien desde el principio. Esta herramienta me ha servido mucho para verificar que todo esté correcto. Incluso si estás utilizando herramientas automáticas para generar EPUBs, te recomiendo pasarle esta validación para tener un “doble chequeo”.

Lo importante aquí es entender algo clave:

Que un editor de EPUB tenga “validador” no significa que sea suficiente.

Yo utilizo EpubCheck incluso cuando el archivo ya pasó por editores automáticos. Es mi doble chequeo antes de publicar.

Validadores online: cuándo usarlos y cuándo no

Existen validadores online que funcionan sobre EpubCheck y pueden servir para pruebas rápidas. El problema es que:

• Tienes límites de tamaño
• Subes archivos personales
• No siempre muestran todo el detalle de los errores

Si trabajas con libros propios o profesionales, validar en local es la mejor opción.

¿Cómo instalar y usar EpubCheck?

EpubCheck es una herramienta hecha en Java. Por lo tanto, necesitas tener instalado OpenJDK, Java o puedes usar directamente el que trae Android Studio (que fue mi caso).

Yo hace mucho que no desarrollo en Java, así que no tenía Java instalado de forma nativa. Como Android Studio ya lo trae integrado, simplemente usé ese.

En Mac, el sistema ya me traía OpenJDK preinstalado. En Windows, simplemente accedí a la carpeta donde está el Java de Android Studio y lo ejecuté desde ahí.

Requisitos: Java, OpenJDK o Android Studio

En mi caso no tenía Java instalado porque hacía años que no desarrollaba en Java. La solución fue simple: Android Studio ya incluye Java, así que utilicé directamente ese ejecutable.

• En macOS, OpenJDK suele venir preinstalado
• En Windows, puedes usar el Java que trae Android Studio

No necesitas instalar nada adicional si ya lo tienes.

Ejecución básica en Windows y macOS

Una vez descargado EpubCheck desde su sitio oficial:

1. Descomprime el ZIP
2. Localiza el archivo epubcheck.jar
3. Ejecuta el comando desde la terminal

Pasos para usar EpubCheck

Descarga el paquete de EpubCheck desde el sitio oficial que compartí al inicio del post.

• Descomprime el archivo ZIP, te generará una carpeta con varios archivos.
• Busca el archivo llamado epubcheck.jar.
• Usa un terminal o línea de comandos para ejecutar la herramienta. El comando básico sería:

$ java -jar epubcheck.jar ruta/del/archivo.epub

En mi caso, tuve que indicar la ruta completa del ejecutable de Java de Android Studio, ya que no tenía Java como tal instalado en el sistema.

Cuando ejecutas el comando, si el programa tarda un poco, es buena señal: quiere decir que está procesando el archivo. Si todo está correcto, no verás errores. Si termina demasiado rápido, puede que haya un problema con la ruta o que no esté encontrando el archivo.

En un archivo correcto, el programa simplemente indica que no hay errores. En cambio, cuando hay errores, los muestra claramente.

Cómo saber si la validación fue correcta

Aquí hay un detalle importante que aprendí con la práctica:

• Si tarda un poco → está procesando el EPUB
• Si termina demasiado rápido → suele haber un problema con la ruta

Cuando el EPUB es correcto, EpubCheck no muestra errores.

Si hay problemas, los detalla con precisión quirúrgica.

Errores comunes al validar EPUBs

También me encontré errores por etiquetas mal ubicadas, como <div> en posiciones no permitidas. Esto suele pasar al:

• Exportar desde Google Docs
• Usar Sigil o InDesign sin limpiar código

EpubCheck indica archivo exacto y línea, lo que hace que la corrección sea directa y rápida.

Por ejemplo, uno de mis libros tenía errores porque personalicé una fuente pero no la había incluido físicamente en el EPUB, aunque sí la referencié en el CSS. EpubCheck me lo indicó de forma clara y me permitió corregirlo rápidamente:

ha encontrado en el EPUB.
ERROR(RSC-007): I:/descargas/librosacademia/laravel/es/laravel.epub/OEBPS/chapter22.xhtml(42,13): El recurso referenciado "OEBPS/fonts/SUSE-ExtraBold.ttf" no se ha encontrado en el EPUB.
ERROR(RSC-007): I:/descargas/librosacademia/laravel/es/laravel.epub/OEBPS/chapter22.xhtml(47,13): El recurso referenciado "OEBPS/fonts/SUSE-Regular.ttf" no se ha encontrado en el EPUB.
ERROR(RSC-007): I:/descargas/librosacademia/laravel/es/laravel.epub/OEBPS/chapter22.xhtml(52,13): El recurso referenciado "OEBPS/fonts/SUSE-SemiBold.ttf" no se ha encontrado en el EPUB.

Prueba finalizada con errores
Mensajes: 0 errores fatales / 405 errores / 0 advertencias / 0 indicaciones

EPUBCheck completado

C:\Users\andre>
C:\Users\andre>
C:\Users\andre>
C:\Users\andre>
C:\Users\andre>"C:\Program Files\Android\Android Studio\jbr\bin\java.exe" -jar "I:\descargas\epubcheck-5.2.1\epubcheck.jar" "I:\descargas\librosacademia\mac\alpine\es\Primeros pasos con Alpine.js, tu nuevo y ligero framework JavaScript.epub"
Validación usando la versión de reglas epub 2.0.1.

También he tenido archivos con errores como etiquetas <div> mal ubicadas o archivos no encontrados dentro del EPUB. A veces, esto es causado por editores como Sigil, o incluso cuando exportas desde Google Docs y se pierde alguna referencia. EpubCheck te muestra exactamente cuál archivo tiene el problema y en qué línea ocurre:

ERROR(RSC-005): I:/descargas/librosacademia/mac/alpine/es/Primeros pasos con Alpine.js, tu nuevo y ligero framework JavaScript.epub/OEBPS/chapter3.xhtml(670,2115): Error al analizar el archivo: el elemento "div" no se permite aquí; se esperaba el elemento final de etiqueta, texto o elemento "a", "abbr", "acronym", "applet", "b", "bdo", "big", "br", "cite", "code", "del", "dfn", "em", "i", "iframe", "img", "ins", "kbd", "map", "noscript", "ns:svg", "object", "q", "samp", "script", "small", "span", "strong", "sub", "sup", "tt" o "var" (con xmlns:ns="http://www.w3.org/2000/svg")
ERROR(RSC-005): I:/descargas/librosacademia/mac/alpine/es/Primeros pasos con Alpine.js, tu nuevo y ligero framework JavaScript.epub/OEBPS/chapter5.xhtml(603,227): Error al analizar el archivo: el elemento "div" no se permite aquí; se esperaba el elemento final de etiqueta, texto o elemento "a", "abbr", "acronym", "applet", "b", "bdo", "big", "br", "cite", "code", "del", "dfn", "em", "i", "iframe", "img", "ins", "kbd", "map", "noscript", "ns:svg", "object", "q", "samp", "script", "small", "span", "strong", "sub", "sup", "tt" o "var" (con xmlns:ns="http://www.w3.org/2000/svg")
ERROR(RSC-005): I:/descargas/librosacademia/mac/alpine/es/Primeros pasos con Alpine.js, tu nuevo y ligero framework JavaScript.epub/OEBPS/chapter5.xhtml(603,1057): Error al analizar el archivo: el elemento "div" no se permite aquí; se esperaba el elemento final de etiqueta, texto o elemento "a", "abbr", "acronym", "applet", "b", "bdo", "big", "br", "cite", "code", "del", "dfn", "em", "i", "iframe", "img", "ins", "kbd", "map", "noscript", "ns:svg", "object", "q", "samp", "script", "small", "span", "strong", "sub", "sup", "tt" o "var" (con xmlns:ns="http://www.w3.org/2000/svg")

Tambien puedes emplear Android Studio, que tiene una version de Java instalado; aquí te dejo algunos comandos que puedes ejecutar:

--- PC
"C:\Program Files\Android\Android Studio\jbr\bin\java.exe" -jar "I:\descargas\epubcheck-5.2.1\epubcheck.jar" "I:\descargas\librosacademia\laravel\es\laravel.epub"

--- MacOS
java -jar "/Volumes/My Passport/archivos/descargas/libros ready/epubcheck-5.2.1/epubcheck.jar" "/Volumes/My Passport/archivos/descargas/libros ready/flask/es/Primeros pasos con Flask 3.epub"

Cómo corregir los errores que muestra EpubCheck

Aquí no hay magia: hay que leer el mensaje y actuar.

Interpretar los mensajes de error

EpubCheck indica:

• Tipo de error
• Archivo afectado
• Línea exacta

Esto es infinitamente mejor que “algo está mal”.

Ejemplos reales y soluciones prácticas

En mi experiencia, los errores más frecuentes se solucionan:

• Incluyendo recursos olvidados
• Corrigiendo rutas
• Limpiando etiquetas HTML mal cerradas

Una vez corriges y vuelves a ejecutar EpubCheck, el archivo suele quedar limpio rápidamente.

Validar EPUBs sin instalar nada

Si solo quieres una comprobación rápida, existen validadores web basados en EpubCheck. Funcionan, pero yo los veo más como:

• Prueba puntual
• EPUBs pequeños
• Casos no sensibles

Para trabajo profesional, sigo recomendando validación local.

Recomendaciones finales antes de publicar tu EPUB

Después de varios libros validados (y algunos errores aprendidos a golpes), mi consejo es claro:

• Valida siempre, aunque el EPUB “se vea bien”
• Usa EpubCheck oficial, no solo validadores integrados
• Corrige errores antes de subir a plataformas
• Trata la validación como parte del flujo profesional

Validar EPUBs es prevenir problemas, rechazos y dolores de cabeza innecesarios.

Conclusión

Validar EPUBs no es un paso opcional ni técnico solo para expertos. Es una práctica esencial si quieres publicar libros electrónicos de forma profesional.

Con EpubCheck, Java y unos minutos de revisión, puedes asegurarte de que tu libro cumple los estándares, será aceptado por las plataformas y funcionará correctamente en cualquier dispositivo.

Extra: Generar un Microsoft Word de un Epub (Y otros formatos)

▶

Aquí te voy a mostrar algo que creo que casi nadie dice: cómo puedes generar un Word a partir de un Epub. Así que, pues nada, como te digo, le pregunté un poquito a la inteligencia artificial y me dijo que con Word, que es el programa que tengo por aquí, el más sencillo, como quien dice, porque el otro es el de Adobe Acrobat, que es más complicado, así que por ahí no voy, intenté con abrir un PDF con Word pero tampoco tuve éxito.

Existen aplicaciones web que no me gustan mucho porque es un libro personal mío. Entonces, no quiero subirlo a estas aplicaciones, y es de saber que, como quien dice, cuando tú subes un documento, ¿qué es lo que está ahí? se adueña de tu documento, a lo que quiero llegar. Porque tú no sabes ahí cuáles son sus condiciones, que las pueden cambiar, las pueden colocar; sabes que todo el mundo es muy tramposo.

La Solución: Calibre al Rescate

Así que, pues nada, entonces en ese caso, ¿qué es lo que dice? Emplear aquí un poquito la lógica. Por suerte, ya yo conocí una aplicación que funciona bastante bien para leer, escribir y todo lo demás, que es esta llamada Calibre. Entonces, aquí fíjate que, en este caso, no es un PDF, sino que es directamente un Epub.

Desde Calibre, tienes la opción de convertir y tienes muchos formatos, entre ellos, Word.

Conclusión

En resumen:

• Descarga EpubCheck, es una herramienta gratuita, profesional y confiable.
• Instala Java o usa el de Android Studio si ya lo tienes.
• Ejecuta la validación con el comando java -jar epubcheck.jar seguido de la ruta del archivo.
• Corrige cualquier error que se muestre. Es mejor prevenir que subir un libro con problemas.