3.1.Documento R Markdown

Tan importante como realizar el análisis de datos de una investigación, también lo es comunicar los resultados a una audiencia, y recibir reconocimiento y comentarios sobre los mismos. En RStudio tenemos una manera de hacer todo lo anterior, utilizando documentos R Markdown.

3.1.1. Archivo R Markdown en RStudio

Al finalizar esta sección podras crear y preparar el formato general de un documento R Markdown

Preparación para documento R Markdown

Primero, comprueba si tienes instalado el paquete rmarkdown; para ello, busca en el menú de Packages (User Library). Si no lo tienes, puedes instalarlo de la manera usual, con Install, o usando la consola: install.packages(‘rmarkdown’).

Documentos PDF

Para generar documentos PDF es necesario tener instalado LaTex en la computadora, o usar TinyTex con el paquete tinytex.

Documentos Word

Requiere tener una licencia autorizada de Word.


Abrir documento R Markdown

Para crear un documento de R Markdown, usa el menú de la esquina superior izquierda, del panel de RStudio:

 


Se abrirá una ventana (si no tienes instalado rmarkdown te aparecerá un mensaje):



en la que puedes poner un título de lo que vas a trabajar en el documento y pulsar OK.

El documento que se abre tiene esta forma, usualmente:


Un documento R Markdown contiene tres elementos principales:

El encabezado YAML o metadata controla la configuración general del documento R Markdown.
Los “chunks” de código R (también pueden incluirse otros lenguajes) permiten incluir códigos dentro del documento, que corren de manera independiente y controlable.
El área de edición de texto, imágenes, videos, tablas, enlaces, ecuaciones, et c. 


Metadata YAML

La metadata para R Markdown se puede escribir al principio de un documento, comenzando y terminando con tres guiones - - -, respectivamente. Los metadatos YAML suelen constar de pares etiqueta-valor separados por dos puntos (:). Es importante la indentación:

Las siguientes instrucciones jerarquizadas, no funcionan si se escriben así:

output:
html_document:
toc: yes


Para que funcionen deben escribirse:

output:
   html_document:
     toc: yes

 

Título del documento

Las etiquetas title:, author: y date: sirven para crear un título del documento con un nombre del documento, nombre del autor y la fecha de creación.

Documento final

El documento final a producir puede indicarse con la etiqueta output:, y entre toros podemos crear:

  • página HTML para la web: html_document
  • documento Word: word_document
  • documento PDF: pdf_document

Opciones para los documentos finales

Dentro de cada etiqueta de documento se pueden incluir otras sub-etiquetas que determinan opciones de formato del documento, como:

  • css: para usar un archivo de comandos CSS que sirve para indicar tipo de letra, tamaño, colores, et c., en el documento final HTML,
  • toc: para producir una tabla de contenido.