3  Repaso: Introducción a Markdown

3.1 ¿Qué es Markdown?

Markdown es un lenguaje de marcado ligero que permite añadir elementos de formato a documentos de texto plano. Creado por John Gruber en 2004, Markdown es actualmente uno de los lenguajes más populares del mundo.

  • Sencillo y legible, sin necesidad de usar editores complicados o HTML.
  • lenguaje de marcado ligero: Escribir texto que incluye instrucciones simples para darle formato.
Note🧩 ¿Por qué se llama “ligero”?

Porque:

  • Usa símbolos sencillos como *, #, o - para indicar formato.
  • No requiere cerrar etiquetas como <strong> o <div> (como en HTML).
  • Es minimalista y limpio, ideal para escribir rápido sin distracciones.

3.2 🧠 ¿Para qué se usa?

  • Crear documentación técnica o científica
  • Escribir README.md en proyectos de GitHub
  • Generar contenido para sitios web
  • Crear tesis, notas, libros, presentaciones y posters

En R

Paquete / Programa Uso principal
rmarkdown Crear documentos reproducibles con texto, código y resultados
knitr Ejecutar chunks de código en RMarkdown
Quarto Plataforma moderna para documentos con R, Python, etc.
bookdown Crear libros técnicos con Markdown + RMarkdown
blogdown Generar blogs científicos usando Markdown y Hugo
flexdashboard Dashboards interactivos escritos en Markdown

En Python

Paquete / Programa Uso principal
Jupyter Notebooks Celdas Markdown para explicar y documentar junto con código
Quarto Igual que en R, permite combinar Markdown con código Python
mkdocs Generar sitios web de documentación técnica desde archivos Markdown
Sphinx + MyST Documentación avanzada con soporte para Markdown
markdown, mistune Librerías para convertir Markdown a HTML
nbconvert Exportar notebooks con Markdown a PDF, HTML, LaTeX, etc.

3.3 ¿Cómo funciona?

Pasos generales:

  1. Crear un archivo Markdown con un editor de texto o una aplicación específica. El archivo debe tener la extensión .md o .markdown.
  2. Se abre el archivo Markdown en una aplicación Markdown.
  3. Se utiliza la aplicación Markdown para convertir el archivo Markdown en un documento HTML.
  4. Visualización del archivo HTML en un navegador web o use la aplicación Markdown para convertirlo a otro formato de archivo, como PDF.
Note

La aplicación y el procesador de Markdown son dos componentes independientes. Para simplificar, los he combinado en un solo elemento (“aplicación de Markdown”) en la figura a continuación.

Imagen tomada de: https://www.markdownguide.org/getting-started/

3.4 Sintaxis de escritura y formato básicos

Revisar la documentación de GitHub

3.5 Tablas con datatable

Code 
library(dplyr)

iris %>%
  head(3) %>%
  DT::datatable()
Table 3.1: Tabla decorativa

3.6 library(gt)

Code 
iris %>% 
  head() %>%
  gt::gt() %>%
  gt::tab_spanner(label = "Petalo", columns = vars(Petal.Length,Petal.Width)) %>%
  gt::tab_spanner(label = "Sepalo", columns = vars(Sepal.Length,Sepal.Width))
Sepalo
Petalo
Species
Sepal.Length Sepal.Width Petal.Length Petal.Width
5.1 3.5 1.4 0.2 setosa
4.9 3.0 1.4 0.2 setosa
4.7 3.2 1.3 0.2 setosa
4.6 3.1 1.5 0.2 setosa
5.0 3.6 1.4 0.2 setosa
5.4 3.9 1.7 0.4 setosa
Note

Si gustas repasar podemos hacerlo con el script Sesion_Rmarkdown_13Oct2023.Rmd del repositorio RmarkdownGraphs_notes.

3.7 Referencias