Prefacio

Motivación

El análisis de datos y la comunicación de hallazgos suelen desarrollarse de forma fragmentada, entre herramientas que no siempre dialogan entre sí. A menudo comenzamos con un script para limpiar los datos o con un cuaderno de programación (notebook) para explorar su contenido. Después añadimos paquetes o librerías para construir visualizaciones, o bien recurrimos a software de terceros para ese mismo fin. Finalmente, esas visualizaciones terminan incrustadas en un reporte estático. Observable Framework (Observable, Inc., s/f) propone una solución integradora que es escribir en Markdown, procesar datos con el lenguaje de programación que prefieras y publicar un sitio estático donde las visualizaciones conserven su interactividad. Este libro es una guía práctica, en español, para recorrer ese flujo de principio a fin.

El flujo completo

La Figura 0.1 condensa la idea central del libro. El valor no reside en cada herramienta por separado, ni en lenguajes de programación como Python o R para cargar datos, ni en la librería Plot para visualizarlos, ni en Markdown para redactar, sino en la posibilidad de reunirlas dentro de un mismo proyecto sujeto a control de versiones. En ese entorno, un cambio en los datos o los análisis repercute en la visualización cada vez que se reconstruye el sitio, y el resultado conserva su interactividad sin depender de un servidor activo(Observable, Inc., 2026).

Esa integración reúne tres tradiciones que hasta hace poco avanzaban por caminos distintos. Allí convergen la programación, los cuadernos computacionales reactivos (Perkel, 2021) y los generadores de sitios estáticos. Observable Framework las articula de manera que el análisis exploratorio y el producto publicado comparten un mismo código fuente, sin traducciones intermedias ni exportaciones manuales.

A quién está dirigido

Este libro está pensado para quienes ya trabajan con datos y quieren publicar sus análisis y visualizaciones como sitios web sin tener que montar infraestructura propia. No requiere experiencia previa con Observable Framework, aunque sí supone una familiaridad básica con la línea de comandos, el control de versiones con Git y al menos un lenguaje de programación para manipular datos. Las personas que provienen del periodismo de datos, la investigación académica, la docencia y la divulgación encontrarán en estas páginas un camino directo hacia productos editoriales reproducibles.

Cómo leer este libro

Las cinco partes siguen el orden natural del flujo de datos y pueden leerse de corrido como un curso, o consultarse de forma independiente cuando necesites resolver un problema puntual. El sidebar a la izquierda mantiene siempre visible la estructura completa del libro y permite saltar a cualquier capítulo.

• Parte I — Fundamentos explica qué es Observable Framework, cómo instalarlo y cómo se organiza un proyecto.
• Parte II — Datos se concentra en los data loaders, en cómo cargar, transformar y consultar datos desde Python, R, JavaScript o SQL.
• Parte III — Visualización con Plot introduce la gramática de gráficas de Observable Plot, desde marcas básicas hasta configuración avanzada de ejes y mapas.
• Parte IV — D3 y más allá desciende a SVG y D3 para visualizaciones a medida que escapan a la API de Plot.
• Parte V — Interactividad y componentes cierra con inputs reactivos, controles personalizados y componentes reutilizables.

Si tienes prisa, los capítulos 1, 5 y 8 forman una ruta mínima: instalación, carga de datos y primeras visualizaciones.

Convenciones

A lo largo del libro encontrarás las siguientes convenciones tipográficas y editoriales:

Las figuras se numeran como Figura N.M, donde N es el número del capítulo (0 corresponde a este prefacio). Los bloques de código identifican el lenguaje de programación en su esquina superior y, cuando son ejecutables dentro del libro, muestran su salida inmediatamente debajo. Las citas bibliográficas usan la sintaxis [@clave] y colocan las referencias al pie de cada capítulo. Los data loaders se identifican por su doble extensión (datos.csv.py, series.json.R, tabla.parquet.sh), una convención del framework que indica el formato de salida y el intérprete que la genera.

Requisitos previos

Para leer el libro basta con un navegador moderno. Para reproducir los ejemplos en tu máquina necesitas:

• Node.js ≥ 20 — para ejecutar Observable Framework.
• uv — gestor de Python que utilizan los data loaders del libro.
• Git — para clonar el repositorio y para que los ejemplos de versionado funcionen.

La guía de contribución del repositorio detalla la instalación paso a paso y el flujo de trabajo recomendado para personas que quieran proponer cambios.