Introducción

Última actualización: 2025-06-27 | Mejora esta página

Tiempo estimado: 12 minutos

Hoja de ruta

Preguntas

  • ¿Cómo se escribe una lección usando R Markdown y sandpaper?

Objetivos

  • Explicar cómo usar markdown con la nueva plantilla de lección
  • Demostrar cómo incluir fragmentos de código, figuras y bloques de actividades anidados

Introducción

Esta es una lección creada mediante el template de Workbench adaptada por MetaDocencia, creada por The Carpentries. Está escrita en
Markdown con sintaxis de Pandoc para archivos estáticos (con extensión .md) y
R Markdown para archivos dinámicos que pueden renderizar código y mostrar el resultado
(con extensión .Rmd). Consultá la Introducción a The Carpentries
Workbench para ver la documentación completa.

Hay tres secciones requeridas para una plantilla de lección válida:

  1. questions se muestran al comienzo del episodio para preparar a la persona que aprenderá el contenido.
  2. objectives son los objetivos de aprendizaje del episodio y se muestran junto con las preguntas.
  3. keypoints se muestran al final del episodio para reforzar los objetivos.

Las notas para instructores en línea pueden ayudar a anticipar desafíos y almacenar notas de la persona oradora.
Aparecen en la “Vista para instructores”.

Desafío 1: ¿Podés hacerlo?

¿Cuál es el resultado de este comando?

R 

paste("Esta", "nueva", "lección", "luce", "bien")

SALIDA 

[1] "Esta nueva lección luce bien"

Desafío 2: ¿cómo anidar soluciones dentro de bloques de desafío?

Es posible gregar una línea con al menos tres dos puntos y la etiqueta solution.

Figuras

Podés incluir figuras generadas desde R Markdown:

R 

pie(
  c(Sky = 78, "Lado soleado de la pirámide" = 17, "Lado sombreado de la pirámide" = 5), 
  init.angle = 315, 
  col = c("deepskyblue", "yellow", "yellow3"), 
  border = FALSE
)
ilusión de gráfico circular de una pirámide
El sol sale cada mañana

O podés usar markdown de pandoc para figuras estáticas con la siguiente sintaxis:

![subtítulo opcional que aparece debajo de la figura](url de la figura){alt='texto alternativo para accesibilidad'}

Logo de MetaDocencia con una manzana y texto del nombre de la Organización.
¡Estás participando de un curso de MetaDocencia!

Matemática

El contenido puede contener ecuaciones en \(\LaTeX\) al describir cómo crear
informes dinámicos con {knitr}, por lo que usamos MathJax para mostrarlas así:

$ lpha = \dfrac{1}{(1 - eta)^2}$ se convierte en: $ lpha = $

¿Genial, no?

Puntos Clave

  • Usá archivos .md para episodios con contenido estático
  • Usá archivos .Rmd para episodios que necesiten generar salidas dinámicas
  • Ejecutá sandpaper::check_lesson() para identificar problemas en tu lección
  • Ejecutá sandpaper::build_lesson() para previsualizar tu lección localmente