36. Exportación a LaTeX {#36-exportación-a-latex}

LaTeX es un sistema de composición tipográfica de alta calidad, estándar en matemáticas, física, ingeniería y publicaciones académicas. Exportar Markdown a LaTeX permite escribir en un formato sencillo y aprovechar después el control fino de LaTeX: fórmulas, referencias cruzadas, bibliografía, teoremas y estilo editorial.

36.1 Cuándo exportar a LaTeX {#361-cuándo-exportar-a-latex}

• Artículos, tesis y memorias con muchas fórmulas.
• Documentos que deben integrarse en una plantilla LaTeX existente.
• Publicaciones que exigen clases o paquetes concretos.
• Presentaciones con Beamer.
• Libros con control de página, índices y numeración.

Si solo necesitas un PDF corriente, suele ser más directo usar Pandoc + xelatex (capítulo 33). Exportar a .tex tiene sentido cuando vas a editar o integrar el LaTeX.

36.2 Conversión básica {#362-conversión-básica}

# Documento compilable
pandoc README.md -t latex -s -o README.tex

# Con numeración y código con listings
pandoc README.md -t latex -s --number-sections --listings -o README.tex

# Con clase de libro y división por capítulos
pandoc manual.md -t latex -s \
  --top-level-division=chapter \
  -V documentclass=book \
  -o manual.tex

36.3 Estructura del archivo generado {#363-estructura-del-archivo-generado}

Un .tex mínimo generado por Pandoc contiene:

\documentclass{article}
\usepackage{amsmath,amssymb}
\usepackage{hyperref}
\usepackage{graphicx}
\usepackage{longtable,booktabs}
\usepackage{xcolor}
\usepackage{listings}

\title{Manual de usuario}
\author{Equipo de documentación}
\date{2026-10-28}

\begin{document}
\maketitle
\tableofcontents

\section{Introducción}\label{introducción}

Texto con \textbf{negrita} y \emph{cursiva}.

\end{document}

Los encabezados se convierten en \section, \subsection o \chapter según --top-level-division y el nivel del encabezado.

36.4 Matemáticas {#364-matemáticas}

Markdown con $...$ y $$...$$ se traduce directamente a matemáticas de LaTeX:

La energía de una partícula es $E = mc^2$.

$$
\int_{0}^{1} x^2 \, dx = \frac{1}{3}
$$

La energía de una partícula es \(E = mc^2\).

\[
\int_{0}^{1} x^2 \, dx = \frac{1}{3}
\]

Para entornos con alineación, usa LaTeX crudo:

```{=latex}
\begin{align}
  a &= b + c \\
  d &= e + f
\end{align}
```

El capítulo 41 cubre la sintaxis matemática y su compatibilidad.

36.5 Referencias cruzadas {#365-referencias-cruzadas}

Pandoc convierte los enlaces internos a referencias de LaTeX. Para figuras, tablas y ecuaciones numeradas, el filtro pandoc-crossref añade etiquetas y referencias:

![Diagrama](figura.png){#fig:arquitectura width=80%}

Como muestra la @fig:arquitectura, el flujo es lineal.

pandoc documento.md -o documento.pdf \
  --filter=pandoc-crossref \
  --number-sections

En LaTeX puro, las etiquetas se escriben así:

\begin{figure}
  \centering
  \includegraphics[width=0.8\textwidth]{figura.png}
  \caption{Diagrama de arquitectura}
  \label{fig:arquitectura}
\end{figure}

Como muestra la figura~\ref{fig:arquitectura}, el flujo es lineal.

• pandoc-crossref: https://github.com/lierdakil/pandoc-crossref

36.6 Bibliografía y citas {#366-bibliografía-y-citas}

Pandoc puede procesar citas con --citeproc y un archivo BibTeX/BibLaTeX:

pandoc articulo.md -o articulo.pdf \
  --citeproc \
  --bibliography=referencias.bib \
  --csl=estilos/apa.csl

O delegar en LaTeX:

pandoc articulo.md -t latex -s \
  --natbib \
  --bibliography=referencias.bib \
  -o articulo.tex

latexmk -pdf articulo.tex

Los estilos CSL están en https://github.com/citation-style-language/styles.

36.7 Código {#367-código}

36.7.1 listings {#3671-listings}

pandoc manual.md -t latex -s --listings -o manual.tex

listings es estable y no requiere compilar con --shell-escape. Se configura con \lstset en la cabecera.

36.7.2 minted {#3672-minted}

minted usa Pygments y produce un resaltado más moderno, pero requiere pygments y compilar con -shell-escape:

\usepackage{minted}

pandoc manual.md -t latex -s \
  --pdf-engine=xelatex \
  --include-in-header=minted.tex \
  -o manual.pdf

minted.tex puede contener:

\usepackage{minted}
\setminted{fontsize=\small, breaklines=true}

36.8 Tablas e imágenes {#368-tablas-e-imágenes}

• Pandoc usa longtable para tablas que pueden partirse entre páginas.
• booktabs mejora las líneas horizontales.
• Las tablas muy anchas requieren tabularx, landscape o rediseño.
• Las imágenes se incluyen con \includegraphics; usa width=0.8\textwidth o centímetros.
• Para figuras flotantes, escribe el entorno figure en LaTeX crudo o usa un filtro.

36.9 Plantillas y preámbulo {#369-plantillas-y-preámbulo}

Para controlar paquetes, colores y estilo:

pandoc manual.md -t latex -s \
  --include-in-header=preambulo.tex \
  --template=plantilla.tex \
  -o manual.tex

preambulo.tex:

\usepackage[spanish]{babel}
\usepackage{fontspec}
\setmainfont{TeX Gyre Pagella}
\setmonofont{TeX Gyre DejaVu Sans Mono}
\usepackage{microtype}
\usepackage{fancyhdr}
\pagestyle{fancy}

Con xelatex o lualatex puedes usar las fuentes instaladas en el sistema; con pdflatex, solo las que tengan codificación adecuada.

36.10 Compilación {#3610-compilación}

# Una pasada
xelatex manual.tex

# Referencias, índice y bibliografía
latexmk -xelatex manual.tex

# Limpiar auxiliares
latexmk -c

LaTeX necesita varias pasadas para resolver referencias, índices y bibliografía. latexmk automatiza el proceso.

36.11 Problemas frecuentes {#3611-problemas-frecuentes}

36.12 Beamer {#3612-beamer}

Para diapositivas:

pandoc charla.md -t beamer -s -o charla.tex
pandoc charla.md -t beamer -s --pdf-engine=xelatex -o charla.pdf

En Markdown, cada encabezado de nivel 1 o 2 puede convertirse en una diapositiva según la plantilla. Usa --slide-level=2 para controlar la división.

---
title: "Introducción a Markdown"
author: "Equipo"
---

# Markdown

## Qué es

Texto...

## Sintaxis

- Títulos
- Listas

El capítulo 39 compara Beamer con otras herramientas de presentaciones.

36.13 Lista de comprobación {#3613-lista-de-comprobación}

• El documento compila sin errores.
• Las fuentes incluyen todos los glifos necesarios.
• Las referencias cruzadas apuntan a etiquetas existentes.
• La bibliografía se genera y ordena correctamente.
• Las tablas y figuras caben en la página.
• El código se resalta y no desborda.
• El índice y los marcadores del PDF son correctos.
• El .tex está versionado junto al Markdown.