Markdown vs LaTeX

Markdown y LaTeX son dos herramientas de escritura basadas en texto plano, pero orientadas a públicos y necesidades muy diferentes. LaTeX es el estándar en el mundo académico, mientras que Markdown domina en el ámbito tecnológico.

Comparativa rápida

Ejemplos lado a lado

Encabezados y texto básico

En Markdown:

# La ecuación de Einstein

La famosa ecuación $E = mc^2$ establece la equivalencia
entre masa y energía.

En LaTeX:

\section{La ecuación de Einstein}

La famosa ecuación $E = mc^2$ establece la equivalencia
entre masa y energía.

Tablas

En Markdown:

| Variable | Descripción       | Unidad |
|----------|-------------------|--------|
| E        | Energía           | Joules |
| m        | Masa              | kg     |
| c        | Velocidad de luz  | m/s    |

En LaTeX:

\begin{table}[h]
\centering
\begin{tabular}{|l|l|l|}
\hline
Variable & Descripción      & Unidad \\ \hline
E        & Energía          & Joules \\ \hline
m        & Masa             & kg     \\ \hline
c        & Velocidad de luz & m/s    \\ \hline
\end{tabular}
\caption{Variables de la ecuación}
\end{table}

Como puedes ver, LaTeX ofrece control sobre la posición de la tabla ([h]), títulos con \caption y formato de bordes preciso, pero requiere mucho más código. Markdown es más directo, aunque con menos opciones de diseño.

Listas

En Markdown:

1. Primer paso
2. Segundo paso
   - Detalle A
   - Detalle B
3. Tercer paso

En LaTeX:

\begin{enumerate}
  \item Primer paso
  \item Segundo paso
  \begin{itemize}
    \item Detalle A
    \item Detalle B
  \end{itemize}
  \item Tercer paso
\end{enumerate}

Imágenes

En Markdown:

![Diagrama del experimento](imagenes/diagrama.png)

En LaTeX:

\begin{figure}[h]
\centering
\includegraphics[width=0.8\textwidth]{imagenes/diagrama.png}
\caption{Diagrama del experimento}
\label{fig:diagrama}
\end{figure}

LaTeX permite controlar el ancho exacto de la imagen, añadir títulos (captions) y crear referencias cruzadas con \label y \ref (por ejemplo, «como se muestra en la Figura \ref{fig:diagrama}»). Markdown no tiene estas funciones de forma nativa.

Bibliografía y referencias

En Markdown (con la extensión de citas de Pandoc):

Según estudios recientes [@garcia2024], la eficiencia
mejoró un 30 %. Otros autores confirman estos
resultados [@lopez2023; @martinez2024].

## Referencias

La bibliografía se genera automáticamente a partir
de un archivo .bib si usas Pandoc.

En LaTeX (con BibTeX):

Según estudios recientes \cite{garcia2024}, la eficiencia
mejoró un 30\%. Otros autores confirman estos
resultados \cite{lopez2023, martinez2024}.

\bibliographystyle{apalike}
\bibliography{referencias}

LaTeX con BibTeX es el estándar en el mundo académico para la gestión de bibliografía. Pandoc permite utilizar una sintaxis similar en Markdown, pero internamente convierte a LaTeX cuando genera un PDF.

¿Cuándo usar Markdown?

Markdown es la mejor opción en estos casos:

• Documentación de software.
• Blogs y artículos web.
• Notas rápidas.
• README y wikis.
• Cuando la velocidad de escritura es prioritaria.

¿Cuándo usar LaTeX?

LaTeX es la mejor opción en estos casos:

• Artículos científicos y tesis.
• Documentos con muchas fórmulas matemáticas.
• Libros técnicos con tipografía profesional.
• Cuando se requiere control preciso del formato.
• Publicaciones académicas con requisitos de formato específicos.

¿Se pueden combinar?

Sí, existen varias formas de combinar lo mejor de ambos:

• Pandoc: Convierte Markdown a LaTeX y viceversa.
• R Markdown: Combina Markdown con código R y salida LaTeX.
• KaTeX/MathJax: Añade fórmulas LaTeX dentro de Markdown.
• Quarto: Sucesor de R Markdown, combina Markdown con múltiples lenguajes.

Herramientas que combinan ambos

Pandoc

Pandoc es la herramienta más versátil para convertir entre Markdown y LaTeX. Puedes escribir tu documento en Markdown y generar un PDF con tipografía LaTeX profesional:

pandoc articulo.md -o articulo.pdf --pdf-engine=xelatex

También puedes aplicar una plantilla LaTeX personalizada para que el PDF resultante cumpla con los requisitos de formato de una revista académica o universidad:

pandoc articulo.md -o articulo.pdf --template=plantilla-tesis.tex

Quarto

Quarto es un sistema de publicación científica de código abierto creado por Posit (la empresa detrás de RStudio). Permite escribir documentos en Markdown que incluyen código ejecutable en Python, R, Julia u Observable y generar salidas en HTML, PDF (vía LaTeX), Word, presentaciones y más. Es especialmente popular en ciencia de datos y análisis estadístico.

R Markdown

R Markdown fue el precursor de Quarto. Permite combinar texto en Markdown con bloques de código R que se ejecutan al compilar el documento. Los resultados (gráficos, tablas, valores) se insertan automáticamente en el documento final. Internamente usa Pandoc y LaTeX para generar PDFs de calidad académica.

Overleaf

Overleaf es un editor LaTeX en línea con colaboración en tiempo real, similar a Google Docs pero para LaTeX. Aunque su formato principal es LaTeX puro, ofrece la posibilidad de importar documentos Markdown y convertirlos. Es la herramienta más popular entre estudiantes e investigadores que trabajan en equipo.

Markdown con notación matemática LaTeX

Una de las combinaciones más habituales es usar la sintaxis de Markdown para el texto y la notación de LaTeX exclusivamente para fórmulas matemáticas. Esta combinación funciona en más plataformas de las que podrías imaginar:

• GitHub: Los archivos .md en repositorios de GitHub renderizan fórmulas LaTeX dentro de bloques $$...$$ y en línea con $...$.
• Obsidian: Soporta KaTeX de forma nativa, lo que significa que puedes escribir $\int_0^1 x^2 dx$ directamente en tus notas.
• Jupyter Notebooks: Las celdas de tipo Markdown aceptan notación LaTeX completa, lo que es ideal para documentar análisis de datos con ecuaciones.
• HackMD / CodiMD: Editores Markdown colaborativos que renderizan fórmulas LaTeX en tiempo real.
• Notion: Soporta bloques de ecuaciones con notación LaTeX usando KaTeX.

Ejemplo de una fórmula en línea dentro de un archivo Markdown compatible:

La desviación estándar se calcula como
$\sigma = \sqrt{\frac{1}{N}\sum_{i=1}^{N}(x_i - \mu)^2}$
donde $\mu$ es la media aritmética.

Casos de uso reales

Un estudiante escribiendo su tesis

Ana es estudiante de física y está escribiendo su tesis de maestría. Su flujo de trabajo combina ambas herramientas:

1. Toma notas de clase en Markdown usando Obsidian, con fórmulas LaTeX en línea para las ecuaciones que ve en clase.
2. Escribe borradores de capítulos en Markdown porque es más rápido y legible para la revisión.
3. Convierte a LaTeX con Pandoc cuando necesita entregar un capítulo al tutor en el formato oficial de la universidad.
4. Usa Overleaf para la versión final colaborativa, donde su tutor puede hacer comentarios directamente.

Este flujo le permite escribir rápido en el día a día (Markdown) y cumplir con los requisitos académicos (LaTeX) sin tener que reescribir nada.

Un desarrollador documentando una API

Carlos es desarrollador back-end y mantiene la documentación de una API REST:

1. Escribe la documentación de los endpoints en archivos Markdown dentro del repositorio (docs/api.md).
2. Incluye fórmulas para explicar algoritmos de pricing: usa notación LaTeX en línea que GitHub renderiza correctamente.
3. Genera un PDF de la documentación técnica con Pandoc para enviar a clientes que no usan GitHub.
4. Publica una versión web usando un generador de sitios estáticos como Astro o MkDocs que procesa los archivos Markdown.

En este caso, Markdown es la fuente única de verdad y las herramientas de conversión se encargan de generar los diferentes formatos de salida.

Conclusión

Si tu trabajo es principalmente académico o científico con mucha notación matemática, LaTeX es la mejor opción. Para todo lo demás, Markdown ofrece una experiencia de escritura más rápida y sencilla. Y con herramientas como Pandoc, siempre puedes convertir entre ambos formatos.