Sobre R Markdown

Este es un documento en formato R Markdown. Markdown es el nombre por el que se le refiere a una sintáxis de formato sencilla para crear documentos HTML, PDF y MS Word. Increíblemente multifacética, ¿cierto?

Para más información respecto a su uso, ¡puedes consultar en el siguiente enlace proporcionado a continuación!: http://rmarkdown.rstudio.com.

A continuación, un poco de experimentación por mi parte con las funciones que aprendí en clase y breves explicaciones :)

Delimitación de secciones

Para esto, tan solo basta escribir un hashtag (#) en frente del título de nuestra sección. El incremento de los números de hashtags que antepones al título significa si se trata de un tema, subtema o ideas secundarias que pertenecen a un subtema.

Así se vería con un hashtag

Así con dos

Así con tres

Resaltado de texto

Si quieres usar algún tipo de resaltado, como negrilla, cursiva (también llamada italics) o aplicarle un color, estos son los pasos que debes de seguir:

Para negrillas, solo debes de abrir y cerrar la palabra o frase con dos asteriscos. Te quedaría así:

Negrilla.

Para la cursiva, debes de poner dos rayitas al piso (_), una al principio y otra al final del texto que deseas resaltar de esta forma. Te quedaría así:

Cursiva, también llamada italics en inglés.

Por otra parte, para darle un poco de vida y personalidad (nada en contra de aquellos que prefieren lo monocromático, pero un poco de color no le caería mal a nuestros documentos), tan solo tendrás que rodear al texto de la etiqueta de apertura y la de cierre . Luego tendrás que usar el atributo color e indicar el color entre comillas. Te quedaría así:

Este texto debería de visualizarse con un color morado.

También puedes indicar el color del texto mediante su código hexadecimal (un arreglo con letras y números que lo antecede un #) esto en caso de estar buscando una tonalidad en particular más allá de como se ven los colores preestablecidos.Así que, en vez de escribir el color, pondrías el código de tu elección. Te debería quedar así:

Este texto debería de estar siendo coloreado por el color Mocha Mouse, designado por Pantone como el color del año 2025. Su código hexadecimal es #A47864, por si te llamó la atención ;)

Finalmente, si quieres subrayar un fragmento de tu texto, encierrra tu texto en la etiqueta entre <> con una u adentro y ciérralo de la misma manera pero antepone una barra (/) antes de la u, así como hemos estado abriendo y cerrando en las demás funciones.

Te quedaría así: Subrayar es muuuuy importante, ¿cierto?

Chunk, o “pedazo” en español (literalmente)

En RMarkdown, un chunk es un bloque donde escribes código R. Lo usas para que tu código se ejecute dentro del documento y muestre resultados como tablas o gráficos.

Para insertarlo, escribe tres tildes invertidas (```) seguidas de {r}. Ojo, no dentro de las llaves, sino por fuera, y de la misma manera cierras el chunk con estas tildes invertidas. Finalmente, escribe tu código dentro de este bloque.

Te debería generar, al ejecutarlo, algo de este estilo:

summary(mtcars)
##       mpg             cyl             disp             hp       
##  Min.   :10.40   Min.   :4.000   Min.   : 71.1   Min.   : 52.0  
##  1st Qu.:15.43   1st Qu.:4.000   1st Qu.:120.8   1st Qu.: 96.5  
##  Median :19.20   Median :6.000   Median :196.3   Median :123.0  
##  Mean   :20.09   Mean   :6.188   Mean   :230.7   Mean   :146.7  
##  3rd Qu.:22.80   3rd Qu.:8.000   3rd Qu.:326.0   3rd Qu.:180.0  
##  Max.   :33.90   Max.   :8.000   Max.   :472.0   Max.   :335.0  
##       drat             wt             qsec             vs        
##  Min.   :2.760   Min.   :1.513   Min.   :14.50   Min.   :0.0000  
##  1st Qu.:3.080   1st Qu.:2.581   1st Qu.:16.89   1st Qu.:0.0000  
##  Median :3.695   Median :3.325   Median :17.71   Median :0.0000  
##  Mean   :3.597   Mean   :3.217   Mean   :17.85   Mean   :0.4375  
##  3rd Qu.:3.920   3rd Qu.:3.610   3rd Qu.:18.90   3rd Qu.:1.0000  
##  Max.   :4.930   Max.   :5.424   Max.   :22.90   Max.   :1.0000  
##        am              gear            carb      
##  Min.   :0.0000   Min.   :3.000   Min.   :1.000  
##  1st Qu.:0.0000   1st Qu.:3.000   1st Qu.:2.000  
##  Median :0.0000   Median :4.000   Median :2.000  
##  Mean   :0.4062   Mean   :3.688   Mean   :2.812  
##  3rd Qu.:1.0000   3rd Qu.:4.000   3rd Qu.:4.000  
##  Max.   :1.0000   Max.   :5.000   Max.   :8.000

También puedes usar Ctrl + Alt + I en RStudio para insertarlo automáticamente. De la misma manera, cuando haces clic en Knit, R ejecuta ese chunk y muestra el código más su resultado.

Si no quieres que el código aparezca (solo el resultado), añade echo=FALSE dentro de las llaves, seguido del título del chunk pero separandolo con una coma, y se vería así:

##       mpg             cyl             disp             hp       
##  Min.   :10.40   Min.   :4.000   Min.   : 71.1   Min.   : 52.0  
##  1st Qu.:15.43   1st Qu.:4.000   1st Qu.:120.8   1st Qu.: 96.5  
##  Median :19.20   Median :6.000   Median :196.3   Median :123.0  
##  Mean   :20.09   Mean   :6.188   Mean   :230.7   Mean   :146.7  
##  3rd Qu.:22.80   3rd Qu.:8.000   3rd Qu.:326.0   3rd Qu.:180.0  
##  Max.   :33.90   Max.   :8.000   Max.   :472.0   Max.   :335.0  
##       drat             wt             qsec             vs        
##  Min.   :2.760   Min.   :1.513   Min.   :14.50   Min.   :0.0000  
##  1st Qu.:3.080   1st Qu.:2.581   1st Qu.:16.89   1st Qu.:0.0000  
##  Median :3.695   Median :3.325   Median :17.71   Median :0.0000  
##  Mean   :3.597   Mean   :3.217   Mean   :17.85   Mean   :0.4375  
##  3rd Qu.:3.920   3rd Qu.:3.610   3rd Qu.:18.90   3rd Qu.:1.0000  
##  Max.   :4.930   Max.   :5.424   Max.   :22.90   Max.   :1.0000  
##        am              gear            carb      
##  Min.   :0.0000   Min.   :3.000   Min.   :1.000  
##  1st Qu.:0.0000   1st Qu.:3.000   1st Qu.:2.000  
##  Median :0.0000   Median :4.000   Median :2.000  
##  Mean   :0.4062   Mean   :3.688   Mean   :2.812  
##  3rd Qu.:1.0000   3rd Qu.:4.000   3rd Qu.:4.000  
##  Max.   :1.0000   Max.   :5.000   Max.   :8.000

Igualmente, una idea interesante para usarlo podría ser para visualizar como se ve el código de algúnn fragmento de tu algoritmo. Por ejemplo, así se ve, en general, la secuencia que seguí para ponerle el color Mocha Mouse a la frase que escribí anteriormente:

<font color="#A47864">Este texto debería de estar siendo coloreado por el color Mocha Mouse, designado por _Pantone_ como el color del año 2025. Su código hexadecimal es #A47864, por si te llamó la atención ;) </font>

Visualización de gráficas, o plots, como se llama aquí en R

Tan solo tienes que contenerlo en un chunk. Sencillo, ¿cierto? Aquí un ejemplo:

Nótese que el parámetro echo = FALSE fue añadido al código de este chunk con el fin de evitar que el código de R implementado se imprimiera y generara molestias en el lector, pues, dependiendo de su profesión o intereses, podrá encontrar este detalle relevante o no.

Conclusión

A lo largo de este documento exploré algunos de los elementos más útiles de R Markdown para crear reportes dinámicos y bien presentados. Aprendí a estructurar texto, resaltar fragmentos importantes con color y estilo, e incluso insertar bloques de código (chunks) que me permiten mostrar resultados directamente en el documento. De la misma forma, busqué explicarte de la manera más apropiada y amigable posible, aunque no soy ninguna profesional, así que disculpáme si algo de lo que dije puede encontrarse ambiguo.

Apenas estoy comenzando, pero ya puedo ver el potencial que tiene esta herramienta para combinar análisis, visualización y redacción en un solo lugar. Lo importante es mantenerse curiosos y seguir cacharreando, así tengamos más errores que aciertos.

¡Gracias por leer! Aquí mi cuenta de Rpubs, (https://rpubs.com/isando6), por si quieres seguirme… o simplemente chismosear mis futuros aprendizajes, errores y aciertos, porque de eso se trata la cultura del cacherreo.