Quarto

¿Qué es?

Quarto es un sistema de publicación técnica y científica open-source, construido sobre Pandoc. Escribes en archivos .qmd que mezclan Markdown con celdas de código (Python, R, Julia, Observable) y Quarto los ejecuta y renderiza a un documento final: HTML, PDF, Word, presentaciones, dashboards, libros o un sitio web completo.

Es el sucesor de R Markdown, ahora agnóstico al lenguaje: para el stack Python ejecuta el código a través de kernels de Jupyter.

¿Para qué sirve?

• Reportes reproducibles donde la narrativa, el código y sus resultados viven en el mismo archivo — al re-renderizar, los números y gráficos se recalculan solos.
• Una fuente, muchos formatos: el mismo .qmd se exporta a HTML, PDF, Word, slides (reveal.js) o un sitio, sin reescribir el contenido.
• Dashboards estáticos y sitios de documentación técnica, versionables en git como cualquier archivo de texto.

¿Cuándo usarla / cuándo no?

Úsala cuando el entregable es un documento o reporte que combina análisis y explicación, y quieres que sea reproducible y exportable a varios formatos. Encaja perfecto encima de un notebook de Jupyter y de gráficos hechos con Matplotlib o seaborn: escribes el análisis una vez y lo publicas donde haga falta.

Piénsalo dos veces si lo que necesitas es un dashboard de BI interactivo con filtros en vivo sobre SQL para usuarios de negocio — ahí Superset está hecho para eso. Si solo quieres explorar datos sin publicar nada, Jupyter a secas alcanza. Y si buscas una app de datos interactiva, mira Streamlit o Dash.

Empieza en 1 minuto

# 1. Instala la CLI de Quarto (elige uno):
#    - Instalador oficial:  https://quarto.org/docs/get-started/
#    - Homebrew (macOS):     brew install quarto
#    - pip (incluye el binario):  pip install quarto-cli

# 2. Crea un proyecto y previsualízalo con recarga en vivo
quarto create project default reporte
cd reporte
quarto preview

Un .qmd mínimo con una celda de Python:

---
title: "Mi primer reporte"
format: html
---

## Ventas por mes

```{python}
import matplotlib.pyplot as plt
plt.plot([1, 2, 3], [10, 40, 25])
plt.show()
```

# Renderiza a otros formatos desde el mismo archivo
quarto render reporte.qmd --to pdf     # o docx, revealjs...