YAMLResume frente a LaTeX

Durante décadas, LaTeX ha sido la forma de facto para que ingenieros, investigadores y académicos produzcan un currículum compuesto tipográficamente de manera profesional. Escribe un archivo .tex, compílalo y obtén un PDF con una tipografía que Word no puede igualar. Un rico ecosistema de plantillas creció alrededor de este flujo de trabajo— Awesome-CV (más de 20 000 estrellas en GitHub), moderncv, Jake's Resume, Deedy-Resume, AltaCV—y Overleaf aloja cientos de plantillas de CV que se compilan en tu navegador.

De la web oficial del proyecto LaTeX:

LaTeX is a document preparation system for high-quality typesetting. It is
most often used for medium-to-large technical or scientific documents but it
can be used for almost any form of publishing.

La cosa es esta: YAMLResume no es una alternativa a LaTeX—está construido sobre él. El motor LaTeX de YAMLResume genera código fuente .tex a partir de tu YAML y lo compila con XeLaTeX, el mismo motor que impulsa los currículums escritos a mano en LaTeX. La comparación real es entre dos flujos de trabajo de autoría: escribir tu currículum directamente en marcado TeX, o escribirlo como YAML estructurado y dejar que un compilador genere el TeX por ti.

Así es como se comparan los dos flujos de trabajo:

Comparación de Características

Diferencias Clave Explicadas

Autoría: Contenido frente a Marcado

La diferencia más inmediata es en lo que miras todo el día. Aquí está la misma entrada laboral, de ambas formas.

En un currículum estilo Awesome-CV escrito a mano:

\cventry{Jan 2020 -- Present}
  {Senior Software Engineer}
  {ACME Inc.}
  {San Francisco, CA}
  {
    \begin{itemize}
      \item Led a team of 5 engineers building payments infrastructure
      \item Reduced p95 latency by 40\% via query optimization
    \end{itemize}
  }

En YAMLResume:

work:
  - name: ACME Inc.
    position: Senior Software Engineer
    startDate: Jan 2020
    summary: |
      - Led a team of 5 engineers building payments infrastructure
      - Reduced p95 latency by 40% via query optimization

Ambos producen una entrada compuesta tipográficamente de manera profesional. Pero en la versión de LaTeX, tu contenido está envuelto en macros, llaves y entornos; en la versión de YAML, tu contenido es el archivo. Cualquiera—incluyendo un colega no programador, un reclutador o tu yo futuro desde un teléfono—puede leer y editar el YAML. Y debido a que el marcado es trabajo del compilador, puedes cambiar cómo se renderiza cada fecha en el documento cambiando cero líneas de tu contenido.

Validación y Depuración

Es aquí donde los dos flujos de trabajo divergen más pronunciadamente.

Con LaTeX escrito a mano, tu única red de seguridad es el compilador. Los errores de TeX son famosos por ser crípticos y en cascada: un & fuera de lugar en tu título laboral puede aparecer como Misplaced \omit en algún lugar profundo de un archivo de clase, y rastrearlo requiere leer el registro cuidadosamente. Los errores de contenido—una fecha mal formada, un campo mal escrito—son solo texto para TeX; felizmente compondrá tipográficamente startDtae.

YAMLResume valida tus datos antes de que se emita una sola línea de TeX. El compilador verifica tu currículum contra un esquema Zod estricto y reporta diagnósticos al estilo de clang con números de línea, números de columna y fragmentos del código fuente infractor:

$ yamlresume validate my-resume.yml
my-resume.yml:9:12: warning: email is invalid.
    email: hi@pp
           ^
my-resume.yml:38:10: error: city is too short.
    city: S
          ^

Para cuando XeLaTeX se ejecuta, los datos son conocidos como buenos, y los fallos de compilación se vuelven lo suficientemente raros como para ser noticia real—generalmente un problema de fuente o paquete que doctor ya señaló.

Separación de Contenido y Presentación

El LaTeX escrito a mano enreda el contenido y la presentación. Cada entrada está envuelta en macros específicas de la plantilla, lo que significa que cambiar de plantilla significa reescribir tu currículum. Pasar de moderncv a AwesomeCV no es un cambio de tema; es convertir cada \cventry en otra macro (o lo que la nueva clase espere) y reorganizar los argumentos.

YAMLResume impone la separación de intereses como principio de diseño:

• content: lo que dice tu currículum
• locale: el idioma y la región en que lo dice
• layouts: cómo se ve—motor, plantilla, página, tipografía, alias y orden de secciones

¿Quieres ver tu currículum en el estilo jake en lugar de moderncv-banking? Cambia una línea en layouts; el archivo de contenido no se toca. Esto también hace que la personalización por aplicación sea trivial: mantén un archivo de contenido canónico, y guarda pequeñas variantes de diseño que reordenen o aliasen secciones.

Una Fuente, Cuatro Motores

Un archivo .tex se compila a PDF. Ese es todo el pipeline, y para muchas personas es suficiente—hasta que un reclutador pide una versión de Word, o quieres tu currículum como una página en tu sitio personal, o necesitas una versión en texto plano para pegar en un formulario de ATS. Pandoc puede convertir LaTeX a DOCX o HTML, pero los resultados son tipográficamente mediocres comparados con un motor construido para el propósito, porque la conversión tiene que adivinar la intención a partir del marcado.

YAMLResume incluye cuatro motores de primera clase—DOCX, HTML, Markdown y LaTeX—y un yamlresume build produce todos ellos desde la misma fuente. El motor Markdown es particularmente útil en 2026: da a los LLMs y parsers de ATS texto limpio y estructurado extraído de los mismos datos validados.

Internacionalización

Escribir un currículum en alemán o chino a mano en LaTeX es un proyecto en sí mismo. El alemán quiere babel con ngerman, cadenas de fechas en alemán y comillas correctas. El chino requiere elegir entre ctex, xeCJK o luatexja, instalar fuentes CJK y configurar fuentes de respaldo—caminos bien transitados para veteranos de TeX, pero genuinamente días de esfuerzo la primera vez. Cada idioma adicional multiplica el trabajo, porque nada se comparte entre documentos.

En YAMLResume configuras la clave locale. El compilador traduce los encabezados de sección, nombres de países, grados, niveles de habilidad y niveles de fluidez; formatea fechas y direcciones de manera idiomática; aplica reglas de puntuación apropiadas para cada configuración regional (incluyendo puntuación de ancho completo para CJK y espacios de no separación antes de signos de puntuación alta en francés); y configura babel y los paquetes CJK correctos para XeLaTeX automáticamente. Y yamlresume ai translate puede producir una traducción que preserva la estructura de todo tu currículum a cualquier configuración regional soportada—convirtiendo un proyecto de composición tipográfica de varios días en un solo comando.

El Techo de Personalización

Para ser justos: el LaTeX escrito a mano gana el concurso de control, y no es una competencia cercana. Cualquier cosa que TeX pueda componer tipográficamente, puedes ponerla en un currículum escrito a mano—diagramas TikZ, macros personalizadas, ajustes micro-tipográficos precisos, listas de publicaciones biblatex para CVs académicos, diseños de varias páginas, una carta de presentación compartiendo la misma clase. Si eres un experto en TeX que disfruta esto, YAMLResume se sentirá como barandillas.

Pero ese techo viene con un costo: todo es tu responsabilidad, para siempre. Cada conflicto de macros, actualización de paquete y caso extremo de fuente es tuyo para arreglar. YAMLResume intercambia el techo infinito por un piso alto: las plantillas seleccionadas codifican decisiones profesionales de tipografía para que no puedas tomar malas decisiones, mientras siguen exponiendo los controles que importan—tamaño de papel, márgenes y números de página, familia de fuentes, tamaño y espaciado entre líneas, y alias y orden de secciones.

Y si alguna vez llegas al techo, hay una salida de emergencia: el código fuente .tex generado se emite junto a tu PDF. Puedes leerlo para aprender, o hacer un fork y tomar el control desde allí. YAMLResume no oculta LaTeX; simplemente no lo requiere.

Ecosistema

Plantillas

La mayor fortaleza del ecosistema de LaTeX escrito a mano es su escala: miles de plantillas de currículum en GitHub, la galería de Overleaf, CTAN y sitios de curación, en cada estilo visual imaginable. La contrapartida es la varianza de calidad—las plantillas van desde clases meticulosamente mantenidas hasta exportaciones únicas con valores hardcodeados, uso de paquetes obsoleto y sin validación.

YAMLResume adopta el enfoque seleccionado: un pequeño conjunto de plantillas oficiales de LaTeX (moderncv-classic, moderncv-casual, moderncv-banking, jake, etc.), cada una probada contra los 12 códigos de configuración regional, para que un cambio de plantilla nunca rompa silenciosamente un currículum localizado.

Overleaf

Overleaf es lo más cercano que el mundo de LaTeX tiene a una experiencia tipo YAMLResume: cero instalación, una galería de plantillas y compilación automática con cada pulsación de tecla, además de una colaboración en tiempo real genuinamente excelente. Si quieres permanecer en un flujo de trabajo LaTeX, es la forma más fácil de hacerlo.

Las contrapartidas son estructurales: tu proyecto vive en un servicio en la nube; funciones como historial de versiones, control de cambios y sincronización con GitHub están detrás de planes de pago; y aún tienes un documento .tex—sin datos estructurados, sin exportación multi-formato, sin validación de esquema, sin CLI. YAMLResume te da la velocidad de iteración tipo Overleaf localmente mediante yamlresume dev, con Git como tu historial de versiones.

CI/CD

Ambos flujos de trabajo se automatizan. El mundo de LaTeX tiene soluciones de la comunidad como latex-action para GitHub Actions, y Overleaf puede sincronizarse con GitHub como una función de pago. YAMLResume incluye una GitHub Action oficial que valida tu currículum y construye los cuatro formatos en un solo paso:

- uses: yamlresume/action@v0.16.1
  with:
    resumes: |
      resume-en.yml
      resume-zh.yml
      resume-fr.yml

Debido a que la entrada es YAML estructurado, CI también puede hacer cosas que ningún pipeline de .tex puede: fallar un pull request que introduce un error de esquema, diff de cambios de contenido sin ruido de marcado, o regenerar todas las variantes localizadas desde una sola edición.

Resumen

LaTeX escrito a mano destaca si quieres:

• Total control tipográfico—macros personalizados, gráficos TikZ, bibliografías biblatex, espaciado preciso, cualquier diseño que puedas imaginar
• Acceso a miles de plantillas y clases de la comunidad en cada estilo
• La misma cadena de herramientas que ya usas para papers, tesis y presentaciones
• Un oficio genuinamente divertido, si TeX es una habilidad que disfrutas mantener
• Conveniencia y colaboración en la nube a través de Overleaf

YAMLResume destaca si quieres:

• Tipografía PDF de nivel LaTeX—mediante XeLaTeX—sin escribir ni depurar TeX
• Datos estructurados y validados con errores al estilo de clang en lugar de registros de compilación
• Formatos de salida extendidos (DOCX, HTML, Markdown, LaTeX/PDF) desde un solo archivo fuente
• Internacionalización profunda en 10 idiomas y 12 códigos de configuración regional, incluyendo configuración automática de CJK, con traducción asistida por IA
• Cambio de plantilla sin reescribir el contenido, gracias a la estricta separación de contenido, configuración regional y diseños
• Una cadena de herramientas de desarrollador: modo de observación, diagnósticos de entorno, Docker, Homebrew y una GitHub Action para CI/CD

Elige LaTeX escrito a mano si ya conoces TeX, necesitas diseños más allá de lo que cualquier esquema estructurado puede expresar, o consideras la composición tipográfica parte del oficio.

Elige YAMLResume si quieres la salida por la que LaTeX es famoso, pero preferirías que tu currículum se lea como datos en lugar de como un programa.