Markdown

Creación de documentos dinámicos con Quarto

Author
Affiliation

Mtro. Santiago Ríos

Cursos Orca

Quarto es una herramienta poderosa que permite crear documentos dinámicos combinando texto, código (R, python) y resultados de análisis en un solo archivo. Utiliza Markdown, un lenguaje de marcado sencillo, junto con el poder de R para facilitar la creación de informes reproducibles y presentaciones visualmente atractivas.

Quarto es el sucessor de R Markdown, y ofrece una serie de mejoras y nuevas características, como soporte para múltiples lenguajes de programación, integración con Jupyter, y la capacidad de crear documentos interactivos con HTML. En este documento, exploraremos cómo usar Quarto para análisis de datos con R. Sin embargo, la mayoría de los conceptos también se aplican a RMardown.

Qué es Markdown

  • Markdown es un lenguaje de marcado ligero que se utiliza para formatear texto de manera sencilla y rápida.
  • Gracias a su simpleza, es ampliamente utilizado en la creación de documentos (Word, PDF, HTML), blogs y páginas web.
  • Markdown permite agregar encabezados, listas, enlaces, imágenes, tablas y otros elementos de formato básico. Puedes seguir este tutorial para aprender más sobre Markdown. En esta lección, veremos los conceptos básicos de Markdown y cómo integrarlos con R en Quarto.

Paso 1: Configurar el entorno

Primero, asegúrate de tener Quarto instalado en tu sistema. Puedes hacerlo desde la página oficial de Quarto.

También necesitarás R y RStudio. Si aún no los tienes instalados, puedes descargarlos desde CRAN y RStudio.

Paso 2: Crear un nuevo documento Quarto

  1. Abre RStudio.
  2. Selecciona File > New File > Quarto Document.
  3. Esto abrirá un archivo con extensión .qmd, que es el formato de archivo de Quarto.

Paso 3: Entender la estructura básica de un documento Quarto

Un documento Quarto tiene una estructura simple:

  • YAML header: Al inicio del documento, rodeado por ---, donde defines el título, autor y otros parámetros (como el tipo de documento deseado).
  • Markdown: Para el texto explicativo.
  • Chunks de código: Para integrar el código R directamente en el documento.

---
title: "Análisis de Datos con Quarto"
author: "Tu Nombre"
date: "2024-12-03"
format: html
---

Paso 4: Escribir contenido en Markdown

Markdown te permite añadir texto y formatearlo fácilmente. Aquí algunos ejemplos:

  • Encabezados: Usa # para crear encabezados.

  • Edición de texto: Puedes usar negritas, cursivas y código con Markdown:

  • Agregar links o figuras: Usa [texto](url) para enlaces y ![texto](url) para imágenes:

  • Ejemplo de un documento básico en Markdown:
# Introducción

Este documento demuestra cómo usar **Quarto** con R para análisis de datos.

## Objetivos

- Analizar datos
- Presentar gráficos
- Crear tablas

Paso 5: Integrar código R

Usa bloques de código (chunks) para incluir y ejecutar código R. Estos bloques se inician con ```{r} y terminan con ```.

```{r}

# Cargar librerías
library(tidyverse)

# Crear un conjunto de datos de ejemplo
data <- tibble(
  Categoria = c("A", "A", "B", "B"),
  Valores = c(10, 15, 20, 25)
)

# Resumir datos
resumen <- data %>%
  group_by(Categoria) %>%
  summarise(Media = mean(Valores), Suma = sum(Valores))

# Mostrar resumen
print(resumen)

```

Paso 6: Renderizar el documento

Una vez que hayas terminado de escribir tu documento, puedes renderizarlo (compilarlo) en diferentes formatos, como HTML, PDF o Word.

  • Para renderizar a HTML, simplemente haz clic en el botón “Render” en RStudio.
  • Para cambiar el formato, ajusta el campo format en el YAML header a pdf o docx.

Ventajas de usar Quarto

  • Reproducibilidad: Combina código y resultados en el mismo documento. Algunos journals cuentan con plantillas para recibir documentos en este formato (puedes verlas aquí)
  • Flexibilidad: Soporta múltiples lenguajes de programación y formatos de salida. Revisa la documentación oficial para más detalles.
  • Interactividad: Permite crear documentos interactivos con HTML. Todas las lecciones de este curso, asi como los gráficos interactivos, tablas dinámicas y otros elementos, fueron creados con Quarto.

Recursos Extra

  • Puedes seguir este tutorial para aprender a crear documentos científicos de alta calidad con Quarto y R (link)