Dale un toque pro a tus documentos Markdown: ¡Fondos personalizados para portadas con LaTeX y Pandoc!

¿Cansado de las portadas sosas en tus documentos Markdown? ¡Tenemos la solución! En este artículo, te guiaremos paso a paso para añadir imágenes de fondo a tus portadas, dándoles un aspecto profesional y atractivo. Usaremos LaTeX y Pandoc, dos herramientas potentes que, combinadas, te permitirán crear documentos increíbles.

El poder de una buena portada

Como dice el dicho, “no hay que juzgar un libro por su portada”, pero seamos sinceros: una portada llamativa siempre atrae más la atención. Si estás creando manuales, guías o cualquier tipo de documento, una portada personalizada puede marcar la diferencia.

Manos a la obra: añadiendo un fondo a tu portada Markdown

El truco está en combinar Markdown con LaTeX. Generalmente, tendrás un archivo `.md` con el contenido principal de tu documento. Para la portada, crearemos un archivo adicional, por ejemplo, `guia.tex.md`, que contendrá comandos LaTeX para personalizarla.

Ejemplo de portada básica con LaTeX

Aquí tienes un ejemplo de un archivo `guia.tex.md` para una portada sencilla:

---
title: MANUAL PARA CREAR PORTADAS
subtitle: Guía sencilla para crear portadas para documentos Markdown
author: Luis GuLo
date: 2025
abstract: |
  Este documento es una guia sencilla en el que se muestra como incluir
  una imagen en una portada de una manual.

  No tiene otra pretensión ni complicacion.
---

Para generar el PDF, usa el siguiente comando:

pandoc --pdf-engine=xelatex guia.tex.md guia.md -o guia.pdf

Esto te dará una portada básica, pero podemos ir mucho más allá.

¡Añadiendo la imagen de fondo!

Para incluir una imagen de fondo, necesitamos modificar el archivo `guia.tex.md` con comandos LaTeX adicionales. Aquí está el código completo:

---
title: MANUAL PARA CREAR PORTADAS
subtitle: Guía sencilla para crear portadas para documentos Markdown
author: Luis GuLo
date: 2025
abstract: |
  \color{yellow}
  Este documento es una guia sencilla en el que se muestra como incluir
  una imagen en una portada de una manual.

  No tiene otra pretensión ni complicacion.

header-includes:
  - \usepackage{graphicx}
  - \usepackage{eso-pic}
  - \usepackage{xcolor}
  - \usepackage{titling}
  - \pretitle{\begin{center}\color{white}\Huge}
  - \posttitle{\par\end{center}\vskip 0.5em}
  - \preauthor{\begin{center}\color{white}\large}
  - \postauthor{\par\end{center}}
  - \predate{\begin{center}\color{white}\large}
  - \postdate{\par\end{center}}
  - \
ewcommand\BackgroundPic{
      \put(0,0){
        \parbox[b][\paperheight]{\paperwidth}{
          \vfill
          \centering
          \includegraphics[width=\paperwidth,height=\paperheight,keepaspectratio]{portada_mini.png}
          \vfill
        }
      }
    }

---

\thispagestyle{empty}
\AddToShipoutPicture*{\BackgroundPic}
\maketitle
\pagebreak

Desglosando el código LaTeX

• `\usepackage{graphicx}`, `\usepackage{eso-pic}`, `\usepackage{xcolor}`, `\usepackage{titling}`: Importan los paquetes LaTeX necesarios para manipular imágenes, colores y el título.
• `\ewcommand\BackgroundPic{…}`: Define un nuevo comando llamado `\BackgroundPic` que inserta la imagen de fondo. Asegúrate de reemplazar `portada_mini.png` con la ruta a tu imagen.
• `\thispagestyle{empty}`: Elimina el encabezado y pie de página de la primera página.
• `\AddToShipoutPicture*{\BackgroundPic}`: Añade la imagen de fondo a la página.
• `\color{yellow}`: Cambia el color del texto del abstract a amarillo.
• `\pretitle`, `\preauthor`, `\predate`: Permiten modificar el color y formato del título, autor y fecha, respectivamente. En este caso, se configuran para que sean de color blanco.

Consideraciones importantes sobre la imagen

• Dimensiones: Para un documento A4, una imagen con una proporción de 2480 x 3508 píxeles es ideal para evitar deformaciones. Otras opciones válidas son 1240×1754 o 566×800.
• Color: Ten en cuenta el color predominante de la imagen para elegir un color de texto que contraste y sea legible. En el ejemplo, se usa blanco y amarillo para que destaque sobre un fondo azul oscuro.

Generando el PDF final

Después de modificar el archivo `guia.tex.md`, vuelve a ejecutar el comando Pandoc:

pandoc --pdf-engine=xelatex guia.tex.md guia.md -o guia.pdf

¡Y listo! Ahora tendrás un PDF con una portada personalizada con una imagen de fondo.

Conclusión

Añadir una imagen de fondo a tus portadas Markdown es una forma sencilla de mejorar la presentación de tus documentos y darles un toque profesional. Con LaTeX y Pandoc, las posibilidades son infinitas. ¡Experimenta con diferentes imágenes, colores y diseños para crear portadas que realmente destaquen!

Fuente: Solo con Linux