Cómo escribir tu CV en Markdown

Guía para redactar un currículum en Markdown, exportarlo a PDF con Pandoc y otras herramientas, y mantenerlo bajo control de versiones con Git.

Publicado el 1 de mayo de 2026

Escribir el currículum en Markdown es una de esas decisiones que parece extraña la primera vez y obvia la segunda. Te quedas con un archivo de texto plano que puedes editar en cualquier ordenador, versionar en Git, exportar a PDF cuando lo necesites y aplicar el estilo visual que quieras sin pelearte con Word.

Esta guía cubre el flujo completo: estructurar el CV en Markdown, exportarlo a PDF con Pandoc u otras herramientas, mantenerlo en GitHub y adaptar fácilmente versiones para cada oferta.

Por qué Markdown encaja tan bien con un CV

Las ventajas de redactar el currículum en Markdown frente a Word, Google Docs o Canva son cuatro:

  • Texto plano y portable: el archivo .md se abre en cualquier sistema operativo, en cualquier editor, dentro de 20 años. Olvídate de versiones incompatibles del .docx.
  • Control de versiones: lo metes en Git y queda un historial perfecto de cada cambio. Si te arrepientes de algo, vuelves atrás con un comando.
  • Separación de contenido y estilo: te centras en lo que dice el CV. El diseño viene después, aplicando una plantilla CSS o un template de Pandoc.
  • Variantes adaptadas por oferta: copias el archivo, ajustas tres líneas y exportas un CV específico para esa oferta sin tocar el original.

Estructura básica de un CV en Markdown

No hay un estándar único, pero el patrón que funciona en la mayoría de casos es este:

# Nombre Apellido

[email@ejemplo.com](mailto:email@ejemplo.com) · [tuweb.com](https://tuweb.com) · [LinkedIn](https://linkedin.com/in/tuperfil) · [GitHub](https://github.com/tuusuario)

## Perfil

Resumen profesional en 2-3 frases. Quién eres, qué haces y qué
te diferencia. Evita superlativos vacíos como "apasionado" o
"orientado a resultados".

## Experiencia

### Empresa S.A.  ·  *Cargo*  ·  2023 – Actualidad
- Logro concreto con número (mejoró X en un Y%, redujo Z en W)
- Logro concreto con tecnología (implementó X con Y para Z)
- Logro concreto con escala (lideró equipo de X en proyecto Y)

### Otra Empresa  ·  *Cargo anterior*  ·  2020 – 2023
- Tres bullets más, mismo patrón

## Formación

### Grado en X  ·  Universidad Y  ·  2016 – 2020
Mención de honor en Z. Proyecto final sobre W.

## Habilidades

- **Lenguajes**: Python, TypeScript, Go
- **Frameworks**: React, FastAPI, Django
- **Herramientas**: Docker, Kubernetes, PostgreSQL, Redis

## Idiomas

- Español: nativo
- Inglés: C1 (Cambridge Advanced)
- Francés: B1

Con esta estructura tienes un CV legible en cualquier visor de Markdown y listo para convertir al formato final.

Buenas prácticas al escribir el contenido

Markdown te quita preocupaciones de formato, pero lo que cuenta es el contenido. Algunos puntos donde se gana o se pierde un CV:

  • Bullets con resultados, no con tareas: en lugar de "responsable de mantenimiento de la base de datos", escribe "redujo el tiempo medio de consulta de 1,2s a 200ms migrando los índices a PostgreSQL 16".
  • Verbos en pasado para experiencias terminadas, presente para la actual.
  • Cuantifica siempre que puedas: porcentajes, miles de usuarios, segundos de mejora, euros ahorrados.
  • Ordena por relevancia, no por cronología estricta: si la experiencia más antigua es la más fuerte para esa oferta, no la entierres al final.
  • Mantén el CV en una o dos páginas: el formato PDF resultante debe respetar esa norma.

Exportar a PDF con Pandoc

Pandoc es la herramienta de referencia para convertir Markdown a PDF de forma profesional. El comando básico es:

pandoc cv.md -o cv.pdf

Esto genera un PDF con el estilo por defecto de LaTeX. Para algo más cuidado, conviene aplicar una plantilla. Hay decenas en GitHub con búsquedas tipo "pandoc resume template", pero un comando habitual es:

pandoc cv.md -o cv.pdf --template=plantilla.latex --variable mainfont="EB Garamond"

Si no tienes LaTeX instalado, puedes generar el PDF a través de HTML y un motor como WeasyPrint o Prince:

pandoc cv.md -o cv.html --css estilos.css --standalone
weasyprint cv.html cv.pdf

Este flujo es más fácil de personalizar porque defines el estilo en un archivo .css corriente.

Alternativas a Pandoc

Si Pandoc te resulta complejo, hay otras opciones más amigables:

  • Resumey Pro: editor especializado en CVs en Markdown con plantillas profesionales listas para usar.
  • markdown-cv: plantilla open source con CSS preparado para imprimir.
  • JSON Resume: estándar de CV en JSON con themes que generan HTML y PDF. Hay conversores Markdown → JSON Resume.
  • Marp o conversor de Markdown a PDF directos para casos sencillos.
  • Visual Studio Code con la extensión "Markdown PDF": exporta a PDF en un clic, útil para revisar el resultado rápido.

CV en GitHub Pages

Una de las ventajas menos comentadas: si redactas el CV en Markdown y lo subes a un repositorio público de GitHub, GitHub renderiza el archivo automáticamente. Con un poco más de trabajo y GitHub Pages puedes publicarlo como una web pública en https://tuusuario.github.io/cv, con dominio propio si lo configuras.

Esto tiene dos efectos secundarios útiles: la URL de tu CV es perma-link, así que la incluyes en LinkedIn o en firmas de email sin miedo a que caduque, y los reclutadores que llegan ven el contenido limpio sin tener que descargar un PDF.

Versionar el CV con Git

Una vez tienes el cv.md en un repositorio Git, abres la puerta a workflows interesantes:

  • Cada cambio queda registrado con fecha y razón. Si dentro de un año quieres recordar exactamente qué decía tu CV al cambiar de trabajo, ahí está.
  • Puedes mantener ramas distintas por oferta: una rama oferta-empresa-x con los ajustes específicos, otra oferta-empresa-y con los suyos. La rama main queda como CV genérico.
  • Puedes automatizar la generación del PDF en cada push con GitHub Actions, de modo que siempre haya un PDF actualizado descargable desde el repo.

Tienes ejemplos concretos de esta automatización en el post sobre automatizar Markdown.

Adaptar el CV a cada oferta

Aquí es donde Markdown brilla de verdad. El flujo que recomiendo:

  1. Mantén cv.md como tu CV maestro, con toda tu experiencia.
  2. Para cada oferta, copia el archivo a cv-empresa-x.md.
  3. Recorta o reordena los bullets para enfatizar lo relevante para esa oferta.
  4. Ajusta el perfil del principio para mencionar competencias clave del puesto.
  5. Genera el PDF específico con Pandoc.

Todo el proceso lleva 10-15 minutos por oferta y produce un CV mucho más fuerte que enviar siempre el mismo.

Errores comunes al escribir un CV en Markdown

  • Olvidar que el PDF es lo que se ve: redacta pensando en la versión renderizada, no en el .md crudo. Antes de enviarlo, exporta y revisa el PDF.
  • Sobrecargar de formato: tres niveles de encabezado bastan. No anides listas a más de dos niveles.
  • Usar elementos que no se renderizan bien en PDF: tablas muy anchas, imágenes grandes o emojis pueden romper el layout. Mejor texto y bullets.
  • No revisar la longitud final: un CV de 4 páginas tras exportar a PDF rara vez es bueno. Recorta.
  • Enlaces sin texto descriptivo: en lugar de "ver más aquí", escribe "puedes ver el proyecto X".

Para terminar

Escribir el CV en Markdown es probablemente la mejor inversión de 30 minutos que vas a hacer para tu carrera profesional. Una vez tengas el archivo maestro, generar variantes adaptadas a cada oferta deja de ser una tarea aburrida y se convierte en un ejercicio rápido de edición. Y dentro de cinco años, cuando vuelvas a buscar trabajo, el archivo seguirá ahí, listo para actualizar.

Recursos relacionados

Esto ha sido todo.

👋 Hola! Soy Edu, me encanta crear cosas y he redactado este tutorial. Si te ha resultado útil, el mayor favor que me podrías hacer es el de compatirlo en Twitter.

para estar al día con mi contenido. 😊