Eisvogel y 30+ plantillas Pandoc para convertir Markdown a PDF

Convertir un archivo Markdown en un PDF con calidad de imprenta solía implicar horas peleando con LaTeX, paquetes que no compilan y márgenes imposibles. Las plantillas Pandoc cambian esa ecuación: un directorio comunitario llamado pandoc-templates.org reúne decenas de plantillas listas para producir tesis, currículums, papers académicos, libros y presentaciones a partir de texto plano.

Para quien escribe documentación, reportes o trabajos universitarios en LATAM, esto significa pasar de un simple .md a un documento profesional con un solo comando, versionable en Git como si fuera código.

TL;DR

• pandoc-templates.org reúne decenas de plantillas Pandoc para convertir Markdown en PDF, LaTeX, HTML, DOCX, EPUB y presentaciones.
• Eisvogel, la plantilla LaTeX más popular del directorio, supera las 7.150 estrellas en GitHub y es compatible con Pandoc 3.
• Pandoc, creado por el académico y programador John MacFarlane, es el conversor universal de documentos desde 2006.
• Hay plantillas para tesis doctorales, papers IEEE, currículums, cartas, recetarios y slides en reveal.js.
• El flujo es siempre el mismo: escribís en Markdown y un comando genera el documento final con formato profesional.
• Separar contenido de presentación permite versionar tus documentos con Git igual que el código fuente.

Qué es pandoc-templates.org

pandoc-templates.org es un catálogo curado que indexa plantillas para Pandoc, el conversor de documentos universal. La idea es simple pero poderosa: en lugar de empezar de cero cada vez que necesitás un PDF con buena tipografía, elegís una plantilla del directorio y la reutilizás. El sitio organiza las opciones por formato de salida (LaTeX, PDF, HTML, DOCX, EPUB, PPTX, ODT, reveal.js) y por tipo de documento (artículo, libro, tesis, carta, currículum, presentación, paper, recetario, factura, manuscrito, examen, handout).

El valor del directorio no está en el código que aloja, sino en la curaduría: cada entrada incluye autor, formatos soportados, cantidad de estrellas en GitHub y fecha de última actualización. Eso último importa más de lo que parece, porque muchas plantillas de la comunidad llevan años sin tocarse y algunas dependen de versiones antiguas de LaTeX. Saber de antemano si un proyecto sigue vivo te ahorra una tarde de depuración.

El catálogo separa plantillas por formato de salida y tipo de documento.

Pandoc: el conversor universal que lo hace posible

Nada de esto tendría sentido sin Pandoc. Creado en 2006 por John MacFarlane, profesor de filosofía en la Universidad de California en Berkeley, Pandoc es una herramienta de línea de comandos escrita en Haskell que traduce documentos entre formatos. Su modelo mental es elegante: lee el documento de entrada y construye una representación interna abstracta (un árbol de sintaxis), y desde esa representación genera la salida en el formato que pidas. Esto evita el problema de tener que escribir un conversor para cada par de formatos.

En la práctica, Pandoc entiende Markdown, reStructuredText, HTML, LaTeX, DOCX, EPUB, MediaWiki y muchos más como entrada, y puede producir PDF, HTML, DOCX, EPUB, presentaciones reveal.js o Beamer, entre otros. La pieza que conecta el contenido con el aspecto final es la plantilla: un archivo que define encabezados, portada, índice, fuentes, márgenes y estilo. Ahí entran las plantillas Pandoc del directorio.

💭 Clave: Pandoc separa el qué (tu texto en Markdown) del cómo se ve (la plantilla). Cambiás de plantilla y el mismo contenido pasa de informe corporativo a tesis universitaria sin reescribir una línea.

graph LR
  A["archivo.md (Markdown)"] --> B["Pandoc + plantilla"]
  B --> C["PDF"]
  B --> D["HTML"]
  B --> E["DOCX"]
  B --> F["EPUB"]
  B --> G["Slides reveal.js"]

Las plantillas Pandoc más relevantes del catálogo

Si entrás al directorio por primera vez, conviene saber dónde mirar. Estas son algunas de las plantillas Pandoc con mayor adopción y mantenimiento real:

• Eisvogel — La estrella indiscutida con más de 7.150 estrellas. Es una plantilla LaTeX limpia, pensada originalmente para apuntes y ejercicios de ciencias de la computación, con portada, resaltado de sintaxis y compatibilidad con Pandoc 3. Es el punto de partida recomendado para informes técnicos.
• The Markdown Resume — Casi 1.750 estrellas. Permite escribir tu currículum en Markdown y exportarlo a PDF o HTML, con build local o vía Docker.
• Template for writing a PhD thesis in Markdown (Tom Pollard) — Más de 1.260 estrellas. Marco para escribir una tesis doctoral; nació para una entrega en University College London, pero se adapta a otras universidades.
• IEEE Paper Template for Pandoc — Formatea papers según el estándar IEEE: título, abstract y referencias listos para conferencias y revistas.
• pandoc-letter — Para escribir cartas en Markdown usando la clase letter de LaTeX.
• nyum — Un generador de sitios estáticos para colecciones de recetas, que demuestra que Pandoc va mucho más allá del PDF académico.

La diversidad es el punto fuerte: hay plantillas para tesis, papers de NeurIPS, cartas de presentación académicas, libros en EPUB y slides en reveal.js. Todas comparten el mismo flujo de trabajo basado en Markdown.

Una misma fuente Markdown puede producir PDF, EPUB o slides.

Cómo usarlo en la práctica

El primer paso es instalar Pandoc. El proyecto distribuye binarios para los tres sistemas operativos principales, así que la instalación es directa:

# Windows (winget o Chocolatey)
winget install --id JohnMacFarlane.Pandoc
choco install pandoc

# macOS (Homebrew)
brew install pandoc

# Linux (Debian / Ubuntu)
sudo apt install pandoc

Para generar PDF necesitás además un motor LaTeX. La opción completa es TeX Live; la opción ligera y recomendada para empezar es TinyTeX, que instala solo lo necesario. Con eso resuelto, descargás la plantilla Eisvogel y la colocás en el directorio de plantillas de Pandoc.

Un documento típico en Markdown empieza con un bloque de metadatos en YAML que la plantilla lee para armar la portada y el índice:

---
title: "Informe tecnico Q2 2026"
author: "Equipo de Plataforma"
date: "2026-05-30"
titlepage: true
toc: true
---

# Introduccion

Este informe resume el trabajo del trimestre...

Y la conversión a PDF con la plantilla Eisvogel es una sola línea:

pandoc informe.md \
  -o informe.pdf \
  --template eisvogel \
  --listings

El resultado es un PDF con portada, índice navegable, encabezados consistentes y bloques de código resaltados. Si mañana necesitás el mismo contenido como página web, cambiás -o informe.pdf por -o informe.html y listo.

⚠️ Ojo: el motor LaTeX es la fuente más común de errores en el primer intento. Si un PDF no compila, casi siempre es por un paquete LaTeX faltante, no por la plantilla. Empezá con TinyTeX y agregá paquetes a medida que el log los pida.

Por qué le conviene a un desarrollador en LATAM

Más allá de lo cómodo que resulta, hay una razón de fondo por la que las plantillas Pandoc encajan tan bien en el flujo de trabajo de un programador: tratan los documentos como código. Tu fuente es texto plano, así que entra en Git, se revisa en pull requests, se compara con diff y se construye en un pipeline de CI. Nada de archivos binarios de Word que generan conflictos imposibles de resolver.

Para estudiantes universitarios la ventaja es directa: escribir la tesis en Markdown con una plantilla académica significa concentrarse en el contenido y dejar el formato a la herramienta, cumpliendo las normas de la facultad sin pelear con el procesador de texto. Para equipos de desarrollo, generar documentación técnica, runbooks o reportes de incidentes en PDF a partir de los mismos Markdown que ya viven en el repositorio elimina pasos manuales y mantiene una única fuente de verdad.

También hay un beneficio de portabilidad cultural: el español con tildes, la ñ y los signos de apertura (¿ ¡) se manejan sin problemas siempre que el documento use codificación UTF-8 y un motor moderno como xelatex o lualatex, que es lo que las plantillas Pandoc actuales recomiendan.

💡 Tip: si tu PDF en español muestra caracteres raros en lugar de tildes, agregá --pdf-engine=xelatex al comando. El motor por defecto a veces no maneja bien el Unicode.

Qué sigue

El ecosistema de Pandoc no muestra señales de desaceleración. Con Pandoc 3 ya consolidado, las plantillas más activas del directorio se están actualizando para aprovechar las mejoras del nuevo motor y del manejo de citas con CSL. La tendencia más interesante es la integración con herramientas de escritura como Obsidian, donde ya existen plantillas derivadas de Eisvogel para exportar notas a PDF académico directamente.

Para quien quiera empezar, el camino es claro: instalar Pandoc, elegir una plantilla del directorio según el tipo de documento y probar con un archivo pequeño antes de migrar un proyecto completo. La curva de aprendizaje del primer PDF es la más empinada; después, todo es reutilización.

📖 Resumen en Telegram: Ver resumen

Preguntas frecuentes

¿Necesito saber LaTeX para usar las plantillas Pandoc?

No para el uso básico. Escribís en Markdown y la plantilla se encarga del LaTeX por debajo. Solo necesitás tocar LaTeX si querés personalizar a fondo el estilo, y aun así muchas opciones se controlan desde el bloque YAML.

¿Pandoc es gratis?

Sí. Pandoc es software libre bajo licencia GPL y las plantillas del directorio son proyectos de código abierto en GitHub, en su mayoría con licencias permisivas.

¿Qué necesito instalar para generar un PDF?

Pandoc más un motor LaTeX. Para empezar, la combinación recomendada es Pandoc y TinyTeX, que es liviano. Para uso intensivo, TeX Live trae todos los paquetes de una vez.

¿Sirve para documentos en español con tildes?

Sí, sin problemas, siempre que el archivo esté en UTF-8 y uses un motor como xelatex o lualatex. Eso garantiza que tildes, ñ y signos de apertura se rendericen correctamente.

¿Puedo usar la misma fuente para PDF y para una web?

Esa es justamente la gracia. El mismo .md genera PDF, HTML, DOCX, EPUB o slides cambiando solo el formato de salida en el comando, sin reescribir el contenido.

¿Las plantillas funcionan con cualquier versión de Pandoc?

No necesariamente. Por eso el directorio muestra la fecha de última actualización de cada plantilla. Eisvogel está actualizada para Pandoc 3, pero algunas plantillas más antiguas pueden requerir versiones previas.

Referencias

• pandoc-templates.org — Directorio comunitario que cataloga las plantillas por formato y tipo de documento.
• pandoc.org — Sitio oficial de Pandoc, con descargas e introducción a la herramienta.
• Manual de Pandoc — Referencia completa de opciones, formatos y plantillas.
• Eisvogel en GitHub — Repositorio de la plantilla LaTeX más popular del directorio.
• jgm/pandoc — Código fuente de Pandoc, mantenido por John MacFarlane.

📱 ¿Te gusta este contenido? Únete a nuestro canal de Telegram @programacion donde publicamos a diario lo más relevante de tecnología, IA y desarrollo. Resúmenes rápidos, contenido fresco todos los días.