Cómo escribir un CV en Markdown

Una guía paso a paso para escribir un currículum en Markdown que se convierte en un PDF profesional listo para enviar.

Last updated: 2026-05-15

Datos clave para un CV en 2026

Antes de escribir, conviene tener en mente cómo procesan un CV los reclutadores y los sistemas automáticos. Estos tres datos son los que más condicionan el formato.

+90%
de las grandes empresas (Fortune 500) usan un ATS para gestionar y filtrar candidaturas antes de la revisión humana. [jobscan]
7,4 s
es el tiempo medio que un reclutador dedica al primer examen visual de un CV, según un estudio de eye-tracking ampliamente citado. [ladders]
1 columna
es la estructura que los parsers de ATS interpretan con mayor consistencia frente a layouts de varias columnas o tablas. [greenhouse]

1. Estructura básica

Un CV en Markdown usa tres niveles de encabezado para marcar la jerarquía: `#` para el nombre, `##` para cada sección (Experiencia, Educación…) y `###` para cada puesto o título académico. Es exactamente la jerarquía que CVMarkdown espera para hacer el render, y es además la que mejor interpretan los sistemas ATS, que esperan un único H1 y secciones a un solo nivel.

[greenhouse]

2. Cabecera

La cabecera de un CV en Markdown se compone de tu nombre con `#`, tu rol en negrita y una línea de contacto en texto plano separada por `·` o `|`. Las URLs de LinkedIn o GitHub se detectan automáticamente. Mantén la cabecera sin iconos como imagen ni tablas: los parsers de ATS extraen mejor el email y el teléfono cuando aparecen como texto seleccionable.

[jobscan]

3. Experiencia

Cada puesto se escribe como `### Empresa` seguido en cursiva por `*Rol · Lugar · Fechas*`, y se desarrolla con bullets de logros cuantificables, no de responsabilidades. Las fechas se detectan automáticamente y se alinean a la derecha. Frases como «reduje el tiempo de despliegue de 40 a 8 minutos» se retienen mejor que «trabajé en CI/CD»: estudios de Harvard Business Review muestran que los logros cuantificables se recuerdan con más fuerza en revisiones rápidas.

[hbr]

4. Habilidades

Las habilidades en un CV en Markdown se listan como pares clave-valor: `**Lenguajes:** TypeScript, Go, Python`. CVMarkdown los renderiza con la clave en negrita y el resto inline, ahorrando espacio vertical. Mantén las habilidades como texto plano separado por comas: los ATS detectan keywords mejor en listas inline que dentro de cajas de diseño o iconografía decorativa.

[jobscan]

Markdown te permite escribir en un formato de texto plano fácil de leer y de escribir, y luego convertirlo a HTML estructuralmente válido.
John Gruber, Creador de Markdown [gruber]

Fuentes

Estudios y documentación técnica citados a lo largo de la guía.