1 El texto (en Rmarkdown)

Un documento de Markdown permite escribir texto donde se le puede insertar código de R.

1.1 Encabezados / Títulos

Para colocar el título del párrafo en negritas y con diferentes tamaños se usa el símbolo numeral # separado por un espacio indicando que esa texto corresponde a un encabezado, para el tamaño de este se repite el símbolo las veces que se desee para indicar el tamaño de este donde (# correspondería al H1 en html y ###### al H6 en html)

Esto es un título de nivel 3

Esto es un título de nivel 4

Esto es un título de nivel 5
Esto es un título de nivel 6

1.2 Párrafos / Saltos de línea

Para crear párrafos, se deja una línea en blanco entre cada párrafo, por ejemplo:

Este es el primer párrafo.

Este es el segundo párrafo

Por otra parte, para crear un salto de línea dentro de un párrafo, se dejan dos espacios al final de la última palabra de esa línea, de este modo:

Esta es la primera línea
y este es el salto de línea.

Nota: también se puede forzar el salto de línea usando el símbolo del backslash \ con un salto de línea o también usando la etiqueta HTML
este ultimo es mas efectivo y permite saltos en la misma oracion.

Esta es la primera línea
y este es el salto de línea.

Para poner un texto como comentario se usa Ctr-Shift-C

1.3 Formato del texto

  • Negrita: Para colocar una palabra, oración o párrafo en negritas se debe usar doble ** asteriscos sin espacios entre la palabra de inicio y cerrar con doble asterisco al final sin dejar espacios.
  • Cursiva o itálica: Coloca una palabra, letra, oración o párrafo en letra inclinada itálico al usar un solo asterisco * al comienzo son espacio y terminar con un asterisco sin espacio.
  • Negrita + cursiva: La combinación de ambos se puede lograr usando como símbolo tres asteriscos *** seguido de la palabra u oración que se desea remarcar sin usar espacios, al final se debe colocar otra vez los tres asteriscos para indicar que se ha cerrado la marcación.

Algunos formatos básicos de texto son: bold, cursiva, tachado y la combinación de estos. Por ejemplo:

**Esto es bold** se verá Esto es bold
*Esto es cursiva* se verá Esto es cursiva _Esto es cursiva_ se verá Esto es cursiva
~~Esto es tachado~~ se verá Esto es tachado
***Esto es cursiva bold*** se verá Esto es cursiva bold
~~*Esto es cursiva tachado*~~ se verá Esto es cursiva tachado
<u>Esto es un texto subrayado</u> se verá Esto es un texto subrayado

subíndice F~2~ se verá subíndice F2
Superíndice F^2^ se verá Superíndice F2

1.4 Línea divisora / Regla Línea Horizontal

1.5 Listas

1.5.1 Lista ordenada

Esta lista consiste en la numeración progresiva de los ítems y se realiza colocando el número seguido de un punto separado por un espacio y después se coloca el texto.

  1. Primero
  2. Segundo
  3. Tercero
  4. Cuarto

1.5.2 Lista no ordenada

Se puede usar los símbolos *, +, -.

  • Un elemento de la lista
  • El siguiente elemento de la lista
  • Otro elemento de la lista

1.5.3 Lista ordenada y no ordenada

  1. Esto es una lista ordenada
  2. Segundo elemento de la lista ordenada
    1. Lista ordenada anidada dentro de otra
      • Lista no ordenada anidada a 3er nivel
      • 2do elemento de esta lista
    2. Segundo elemento de la lista ordenada anidada

1.6 Citas

Para citar se debe usar el signo mayor que > separado por un espacio y luego seguido de la oración que tendrá la cita. Se puede anidar varias citas repitiendo el mismo signo con lo cual se incrementa la tabulación. Al hacer doble salto de línea al final del texto rompemos el bloque de la cita.

El símbolo > se usa para poner una cita.

“Hay tres clases de mentiras: las mentiras, las malditas mentiras y las estadísticas.”

Mark Twain

“Democracia: es una superstición muy difundida, un abuso de la estadística.”

Jorge Luis Borges

“Hay tres clases de mentiras: las mentiras, las malditas mentiras y las estadísticas.”

Mark Twain 1

1.7 Insertando imágenes

Para insertar una imagen se usa el signo de exclamación ! seguido de los corchetes para indicar el título y luego de paréntesis () para la ruta. En el caso de varias imágenes se puede colocar entre corchetes una numeración como marcador para vincular esa imagen al final del contenido del documento.

Meme1

Meme1

Para centrar una imagen se usa HTML

Meme1

Otra forma de insertar imágenes:

1.8 Insertando hipervínculos

Para insertar hipervínculos o enlaces webs su sintaxis es similar al empleado para insertar imágenes, la única diferencia es que no se incluye el signo de exclamación.

R para Ciencia de Datos es la traducción del libro de R for Data Science
Link del libro: https://r4ds.had.co.nz/
R para Ciencia de Datos

1.9 Tablas

Para la elaboración de una tabla primero se debe crear el encabezado, el cual esta conformado por los títulos de las columna que están separados con símbolo pipe | , luego se debe hacer un salto de línea con dos espaciados y colocar una línea divisora con el signo menos - , la cual indica el uso de un encabezado con lo que este texto estará en negritas y centrado. Para el contenido se van colocando los datos separándolos con el signo de pipe | al principio y final.

Adicionalmente se tiene lo siguiente:
* :—- margen izquierdo
* :—-: margen central
* —–: margen derecho

Género Porcentaje
Masculino 49.63
Femenino 50.37
Total 100.00

Ver publicación en: Estado de la población peruana 2020

1.10 Ecuaciones

https://www.codecogs.com/latex/eqneditor.php

El modelo de regresión lineal simple es \(Y = \beta _{0}+\beta _{1}+\varepsilon\). La ecuación queda en la misma línea que el texto.

El modelo de regresión lineal simple es \[Y = \beta _{0}+\beta _{1}+\varepsilon\].La ecuación queda en otra línea.

La función de densidad de la distribución normal es: \[f(x)=\frac{1}{\sigma \sqrt{2\pi }}e^{-\frac{(x-u)^{2}}{2\sigma ^{2}}}\]

1.11 Anulando sintaxis Markdown

Cuando necesitamos emplear los caracteres de comandos empleados por Rmarkdown debemos usar el símbolo de escape para indicarle que no ejecute este como comando y solo se muestre como un símbolo, por lo cual usamos es el backslash \.

Markdown utiliza los siguiente símbolos para el marcado:

  • Asterisco: *
  • Guion: -
  • Guion bajo: _
  • Paréntesis: ()
  • Corchetes: []
  • Llaves: {}
  • Punto: .
  • Signo de exclamación: !
  • Almohadilla: #
  • Acento grave: `
  • Barra invertida: \

Para utilizar estos caracteres en un texto, se debe insertar una barra invertida delante de cada uno de ellos.

# Esto no es un título
*Esto no sale en cursiva*
*Esto no sale en cursiva*

1.12 Insertando emojis

Se debe instalar el paquete emp desde github

install.packages("devtools")
devtools::install_github("hadley/emo")

Para ver la lista de emojis usar View(emo::jis)

Para insertar un emoji 📊

1.13 Pie de página

2 Adición de código de R en RMarkdown

2.1 Insertando secciones

2.1.1 Gráfico de barras

2.1.2 Gráfico de barras centrado

2.2 Ejemplo de gráfico de series de tiempo animado

2.3 Insertando una imagen en un chunk

2.4 Insertando una tabla

2.4.1 Cambiando el formato de tabla con kable y kableExtra

paises %>% filter(anio == 2007, continente == "Américas") %>% group_by(pais) %>%
  summarise(media = mean(esperanza_de_vida)) -> tabla
tabla
## # A tibble: 25 × 2
##    pais                 media
##    <fct>                <dbl>
##  1 Argentina             75.3
##  2 Bolivia               65.6
##  3 Brasil                72.4
##  4 Canadá                80.7
##  5 Chile                 78.6
##  6 Colombia              72.9
##  7 Costa Rica            78.8
##  8 Cuba                  78.3
##  9 República Dominicana  72.2
## 10 Ecuador               75.0
## # … with 15 more rows
knitr::kable(tabla)
pais media
Argentina 75.3
Bolivia 65.6
Brasil 72.4
Canadá 80.7
Chile 78.6
Colombia 72.9
Costa Rica 78.8
Cuba 78.3
República Dominicana 72.2
Ecuador 75.0
El Salvador 71.9
Guatemala 70.3
Haití 60.9
Honduras 70.2
Jamaica 72.6
México 76.2
Nicaragua 72.9
Panamá 75.5
Paraguay 71.8
Perú 71.4
Puerto Rico 78.7
Trinidad y Tobago 69.8
Estados Unidos 78.2
Uruguay 76.4
Venezuela 73.7 
knitr::kable(tabla, digits = 2)
pais media
Argentina 75.3
Bolivia 65.5
Brasil 72.4
Canadá 80.7
Chile 78.5
Colombia 72.9
Costa Rica 78.8
Cuba 78.3
República Dominicana 72.2
Ecuador 75.0
El Salvador 71.9
Guatemala 70.3
Haití 60.9
Honduras 70.2
Jamaica 72.6
México 76.2
Nicaragua 72.9
Panamá 75.5
Paraguay 71.8
Perú 71.4
Puerto Rico 78.8
Trinidad y Tobago 69.8
Estados Unidos 78.2
Uruguay 76.4
Venezuela 73.8 
# Usando el paquete kableExtra
knitr::kable(tabla, digits = 3) %>% kable_styling()
pais media
Argentina 75.3
Bolivia 65.6
Brasil 72.4
Canadá 80.7
Chile 78.6
Colombia 72.9
Costa Rica 78.8
Cuba 78.3
República Dominicana 72.2
Ecuador 75.0
El Salvador 71.9
Guatemala 70.3
Haití 60.9
Honduras 70.2
Jamaica 72.6
México 76.2
Nicaragua 72.9
Panamá 75.5
Paraguay 71.8
Perú 71.4
Puerto Rico 78.7
Trinidad y Tobago 69.8
Estados Unidos 78.2
Uruguay 76.4
Venezuela 73.7 
knitr::kable(tabla, digits = 3) %>% kable_styling(bootstrap_options = c("striped",                                                      "hover", 
                                    "condensed"), 
                                    full_width = F)
pais media
Argentina 75.3
Bolivia 65.6
Brasil 72.4
Canadá 80.7
Chile 78.6
Colombia 72.9
Costa Rica 78.8
Cuba 78.3
República Dominicana 72.2
Ecuador 75.0
El Salvador 71.9
Guatemala 70.3
Haití 60.9
Honduras 70.2
Jamaica 72.6
México 76.2
Nicaragua 72.9
Panamá 75.5
Paraguay 71.8
Perú 71.4
Puerto Rico 78.7
Trinidad y Tobago 69.8
Estados Unidos 78.2
Uruguay 76.4
Venezuela 73.7 
# striped (estilo cebra), hover (destacar la fila)
knitr::kable(tabla,digits = 3, caption = "Esperanza de vida en 2007") %>%
kable_styling(bootstrap_options = c("striped",                                                      "hover", 
                                    "condensed"), 
                                    full_width = F) %>%
            scroll_box(width = "800px", height = "200px")
Esperanza de vida en 2007
pais media
Argentina 75.3
Bolivia 65.6
Brasil 72.4
Canadá 80.7
Chile 78.6
Colombia 72.9
Costa Rica 78.8
Cuba 78.3
República Dominicana 72.2
Ecuador 75.0
El Salvador 71.9
Guatemala 70.3
Haití 60.9
Honduras 70.2
Jamaica 72.6
México 76.2
Nicaragua 72.9
Panamá 75.5
Paraguay 71.8
Perú 71.4
Puerto Rico 78.7
Trinidad y Tobago 69.8
Estados Unidos 78.2
Uruguay 76.4
Venezuela 73.7 
tabla %>% top_n(5) %>% ggplot()  + aes(pais,media, fill= pais) + geom_col(show.legend = F) + labs(title = "Países en América con mayor esperanza de vida promedio en 2007", y= "Esperanza de vida media", x = "País") + theme_bw() + 
    theme(plot.title = element_text(face = "bold", size = 12,
                                  hjust = 0.5))

2.4.2 Cambiando el formato de tabla con flextable

paises %>% filter(anio == 2007, continente == "Américas") %>% group_by(pais) %>%
  summarise(Promedio = mean(esperanza_de_vida)) -> tabla1
tabla1
## # A tibble: 25 × 2
##    pais                 Promedio
##    <fct>                   <dbl>
##  1 Argentina                75.3
##  2 Bolivia                  65.6
##  3 Brasil                   72.4
##  4 Canadá                   80.7
##  5 Chile                    78.6
##  6 Colombia                 72.9
##  7 Costa Rica               78.8
##  8 Cuba                     78.3
##  9 República Dominicana     72.2
## 10 Ecuador                  75.0
## # … with 15 more rows
tabla2 <- flextable(tabla1) ; tabla2
tabla3 <- autofit(tabla2)   ; tabla3
tabla4 <- add_header_lines(tabla3, values = "Esperanza de vida promedio en América en 2007") ; tabla4

2.4.3 Resaltando partes de la tabla con flextable

2.5 Mostrando los datos

2.6 Opciones de resultados con código en R

mean(paises$pib_per_capita)
## [1] 7215
mean(paises$esperanza_de_vida)
## [1] 59.5
mean(paises$poblacion)
## [1] 29601212
mean(paises$pib_per_capita)
mean(paises$esperanza_de_vida)
mean(paises$poblacion)
## [1] 7215
## [1] 59.5
## [1] 29601212

2.7 Insertando Código de R dentro de un texto

Es posible poner una estadística o un resultado dentro de un texto. Por ejemplo, la edad promedio es de 45.27 años.

2.8 Insertando código en Python

3

2.9 Temas disponibles

Temas

2.10 Insertar videos de YouTube, Vimeo

Para insertar video se utiliza el paquete vembedr. Mayor información en https://github.com/ijlyttle/vembedr

Se recomienda instalar desde devtools install.packages("devtools") devtools::install_github("ijlyttle/vembedr")

Este es el enlace de YouTube a mostrar: https://www.youtube.com/watch?v=V0eJE55aTrY

Se usan los últimos códigos V0eJE55aTrY

Para poner un tiempo de inicio se usa use_star_time()

Este es el enlace de YouTube a mostrar: https://www.youtube.com/watch?v=KIZI2U2UNog&t=9s

Se usan los últimos códigos KIZI2U2UNog

Este es el enlace de Vimeo a mostrar: https://vimeo.com/178485416

Se usan los últimos códigos 178485416

Se recomienda reproducir en una nueva ventana.

2.11 Recursos para seguir aprendiendo

Mayor información de RMarkdown lo pueden encontrar en los libros de Xie (Xie et al., 2018, 2020). Asimismo, el artículo de Peikert & Brandmaier (2021) ofrece una guía paso a paso de RMarkdown.

Este es el enlace para buscar csl
https://github.com/citation-style-language/styles

Bibliografía

Peikert, A., & Brandmaier, A. M. (2021). A reproducible data analysis workflow with R Markdown, Git, Make, and Docker. Quantitative and Computational Methods in Behavioral Sciences, 1.
Xie, Y., Allaire, J. J., & Grolemund, G. (2018). R markdown: The definitive guide. Chapman; Hall/CRC.
Xie, Y., Dervieux, C., & Riederer, E. (2020). R markdown cookbook. Chapman; Hall/CRC.

  1. Nacido el 30 de noviembre de 1835, en la Florida, Missouri, Samuel L. Clemens escribió bajo el seudónimo de Mark Twain y escribió varias novelas, incluyendo dos grandes clásicos de la literatura americana, “Las aventuras de Tom Sawyer” y “Las aventuras de Huckleberry Finn”. También fue un piloto de barco, un periodista, un conferencista, un empresario y un inventor. Twain murió el 21 de abril de 1910, en Redding, Connecticut.↩︎