Introducción a Quarto

Programa Datex(datos+Exactas) - UNNE

Profesora: Patricia A. Loto

¿Qué es Quarto?

  • 🚀 Es la nueva generación de R Markdown
  • 📝 Creado por Posit (la empresa detrás de RStudio)
  • 🌍 Multi-lenguaje: R, Python, Julia, Observable
  • 🔄 Compatible con documentos R Markdown existentes
  • 🎯 Mismo objetivo: combinar código, resultados y narrativa

En resumen: Quarto te permite crear documentos dinámicos donde código y texto viven juntos

¿Por qué Quarto?

Ventajas

  • ✅ Más formatos de salida
  • ✅ Mejor soporte para sitios web
  • ✅ Presentaciones modernas
  • ✅ No necesita R (funciona solo)
  • ✅ Sintaxis más clara

Casos de uso

  • 📊 Reportes de análisis
  • 📖 Documentación técnica
  • 🎓 Material educativo
  • 🌐 Sitios web y blogs
  • 📽️ Presentaciones (¡como esta!)

Tu Primer Documento Quarto

Crear nuevo documento

  1. File → New File → Quarto Document
  2. Completa título y autor
  3. Selecciona formato de salida (HTML por defecto)
  4. Click en Create

Componentes iniciales

  • YAML: metadatos del documento
  • Texto: tu narrativa en Markdown
  • Chunks: bloques de código R
## Documento Quarto: Estructura básica {.smaller}
title: “Mi Primer Documento” author: “Tu Nombre” format: html 

### 2. Texto/Markdown
```markdown
# Introducción

Este es un párrafo con **negritas** y *cursivas*.

- Lista item 1
- Lista item 2

3. Código R

# Esto es un chunk de código
library(ggplot2)
summary(cars)

:::

Renderizar tu Documento

Método 1: Botón Render

  • Click en Render (o Ctrl+Shift+K)
  • Vista previa automática
  • Opción: Render on Save

Método 2: Consola R

library(quarto)
quarto_render("documento.qmd")

¿Qué sucede?

  1. Se ejecuta el código R
  2. Se genera un archivo .md
  3. Pandoc lo convierte al formato final
  4. Se abre la vista previa

Ejemplo Práctico: Análisis de Pingüinos

---
title: "Análisis de Pingüinos"
format: html
---

## Carga de datos

library(palmerpenguins)
library(dplyr)
library(ggplot2)

data(penguins)
glimpse(penguins)

## Estadísticas básicas

penguins %>%
  count(species)

Formatos de Salida

Quarto puede generar múltiples formatos:

Documentos

  • 📄 HTML
  • 📑 PDF
  • 📝 MS Word

Publicaciones

  • 📖 Libros
  • 🌐 Sitios web
  • 📰 Blogs

Presentaciones

  • 🎥 RevealJS (esta presentación)
  • 🎞️ Beamer (LaTeX)

Interactivos

  • 🎮 Shiny
  • 📱 Dashboards

Cambiar Formato de Salida

Solo modifica el YAML:

---
title: "Mi Documento"
format: html
---
---
title: "Mi Documento"
format: pdf
---
---
title: "Mi Documento"
format: docx
---
---
title: "Mi Presentación"
format: revealjs
---

Chunks de Código: Opciones Básicas

Controla cómo se muestra tu código:

#| echo: true      # Mostrar código
#| eval: true      # Ejecutar código
#| warning: false  # Ocultar advertencias
#| message: false  # Ocultar mensajes

library(ggplot2)
ggplot(mtcars, aes(x = wt, y = mpg)) +
  geom_point()

Consejo

Usa #| (hashpipe) para opciones de chunk en Quarto (nuevo estilo)

¿Cómo Funciona Internamente?

flowchart LR
    A[documento.qmd] --> B[knitr]
    B --> C[documento.md]
    C --> D[pandoc]
    D --> E[HTML/PDF/Word]
    
    style A fill:#e1f5ff
    style E fill:#ffe1f5
  1. knitr ejecuta el código R y genera Markdown
  2. pandoc convierte Markdown al formato final
  3. El botón Render orquesta todo el proceso

Markdown Básico para Quarto

Formato de texto

**negrita**
*cursiva*
`código`
~~tachado~~

Encabezados

# Nivel 1
## Nivel 2
### Nivel 3

Listas

- Item 1
- Item 2
  - Subitem

1. Primero
2. Segundo

Enlaces e imágenes

[texto](url)
![alt](imagen.png)

Ventajas de usar Quarto

  1. Vista previa en tiempo real: ves los cambios inmediatamente
  2. Reproducibilidad: tu análisis está documentado paso a paso
  3. Múltiples formatos: un documento, muchas salidas
  4. Facilita el aprendizaje: combinas teoría (texto) y práctica (código)
  5. Profesional desde el inicio: resultados con aspecto profesional

💡 Consejo: Empieza simple y ve agregando complejidad gradualmente

Flujo de Trabajo Recomendado

Para principiantes:

  1. 📝 Planifica: qué quieres analizar/mostrar
  2. 🎯 Crea el documento .qmd
  3. ✍️ Escribe en pequeños bloques (texto + código)
  4. 🔄 Renderiza frecuentemente para ver resultados
  5. 🐛 Corrige errores sobre la marcha
  6. 🎨 Personaliza formato cuando funcione todo

Recuerda

¡Guarda tu trabajo frecuentemente! (Ctrl+S)

Recursos de Ayuda

Documentación oficial

  • 📚 quarto.org
  • 🎓 Tutoriales paso a paso
  • 📖 Guía de referencia

Comunidad

  • 💬 Posit Community
  • 📺 YouTube tutoriales

Dentro de RStudio

  • ❓ Help → Cheatsheets
  • 🔍 Autocompletado (Tab)
  • 📋 Plantillas incluidas

Errores Comunes y Soluciones

Error Causa Solución
No renderiza Paquete no instalado install.packages("nombre")
Error en chunk Sintaxis de código Revisa la sintaxis
YAML inválido Indentación incorrecta Usa espacios, no tabs
Archivo no encontrado Ruta incorrecta Verifica directorio de trabajo

Tip

Lee los mensajes de error, ¡suelen indicar el problema!

Diferencias con R Markdown

Aspecto R Markdown Quarto
Extensión .Rmd .qmd
Opciones chunk {r, echo=FALSE} #| echo: false
YAML Básico Más opciones
Dependencia Necesita R Independiente
Presentaciones ioslides, slidy RevealJS nativo

Conclusión: Quarto es la evolución natural de R Markdown

Recursos Finales

Para descargar y practicar:

¡Gracias!

Introducción a Quarto