Introducción a R Markdown

En este artículo, exploraremos los conceptos de Markdown en el lenguaje de programación R.

Cubriremos los siguientes temas:

• Introducción a R Markdown
• Ventajas de la rebaja
• ¿Qué es R Markdown?
• ¿Por qué usar R Markdown?
• Primeros pasos con R Markdown

Introducción a R Markdown

Markdown es un lenguaje de marcado ligero y creado por John Gruber en 2004. Hoy en día, Markdown es uno de los lenguajes de marcado más populares del mundo. La extensión de archivo de un archivo Markdown es .md o .markdown . Para compilar un archivo de descuento, el usuario necesita una aplicación capaz de procesar archivos de descuento como Microsoft Word, Dillinger, etc. Estas aplicaciones utilizan un analizador Markdown que convierte un archivo de descuento en código HTML imprimible. 

Ventajas de la rebaja

• Se usa principalmente para escribir páginas formateadas en varias plataformas como StackOverflow, Github y muchas más.
• No está hecho solo para programadores, porque uno puede escribir libros electrónicos con él usando leanpub.
• Convertible a formatos como PDF, HTML, documentos, etc.
• Markdown Files se puede convertir fácilmente en páginas web utilizando herramientas como Github Pages, smallvictori.es y blot.im.

¿Qué es R Markdown?

R Markdown es una forma de generar documentos totalmente reproducibles, en los que se pueden combinar texto y código. Así es como las cosas se pueden hacer como viñetas, negrita, cursiva, enlaces o ejecutar códigos R en línea. A pesar de que todos estos documentos comienzan como texto sin formato, ¡uno puede convertirlos en páginas HTML, PDF, documentos de Word o diapositivas! Los símbolos que se utilizan para señalar, por ejemplo, negrita o cursiva, son compatibles con todos esos formatos. 

¿Por qué usar R Markdown?

• Una de las principales ventajas es la reproducibilidad de usar R Markdown. Ya que simplemente puede combinar texto y piezas de código en un documento, y puede combinar fácilmente introducciones, hipótesis, el código que se está ejecutando, los resultados de ese código y las conclusiones, todo en un solo documento. Compartir lo que hizo, por qué lo hizo y cómo resultó se vuelve tan fácil y esa persona con la que lo comparte puede volver a ejecutar su código y obtener las mismas respuestas correctas que obtuvo. Eso es lo que significa reproducibilidad. Pero también, rara vez estará trabajando en un proyecto que toma muchas semanas en completarse y desea poder ver lo que hizo hace mucho tiempo y puede ver con precisión lo que ejecutó y los resultados de ese código y documentos R Markdown le permite hacer eso.
• Otra gran ventaja de R Markdown es que, dado que es texto sin formato, funciona muy bien con los sistemas de control de versiones . Es simple rastrear qué cambios de carácter ocurren entre confirmaciones; a diferencia de otros formatos que no son texto plano.
• Otra ventaja egoísta de R Markdown es que es muy fácil de usar. Como todo en R, esta funcionalidad extendida proviene de un paquete de R » rmarkdown «. Todo lo que hay que hacer es instalarlo dando este comando install.packages(“rmarkdown”) .

Primeros pasos con R Markdown

Para crear un documento R Markdown, en R Studio, vaya a Archivo > Nuevo archivo > R Markdown . La siguiente ventana aparecerá: 

Como se puede ver, la imagen de arriba se completa con un título y un autor y se cambia el formato de salida a un PDF. Explore alrededor de esta ventana y las pestañas a la izquierda para ver todos los diferentes formatos a los que puede generar. Cuando haya terminado, haga clic en Aceptar y se abrirá una nueva ventana con una pequeña explicación sobre los archivos R Markdown. 

Hay tres secciones importantes de un documento R Markdown. 

• Encabezado: El primero es el encabezado en la parte superior, delimitado por los tres guiones. Aquí es donde el usuario especifica detalles como el título, el nombre, la fecha y el tipo de documento que desea generar. Si el usuario ha rellenado los espacios en blanco de la ventana anteriormente, estos ya deberían estar rellenados.
• Texto: también en esta página, se pueden ver secciones de texto, por ejemplo, una sección comienza con «## R Markdown». Esta sección se representará como texto cuando se produzca el PDF de este archivo y todos los formatos que aprenderá el usuario. generalmente se aplica a esta sección.
• Fragmento de código: Y finalmente, el usuario verá fragmentos de código. Estos están delimitados por los triples backticks. Estos son fragmentos de código R que se pueden ejecutar directamente desde el documento y la salida de este código se incluirá en el PDF cuando se cree. La forma más fácil de ver cómo se comporta cada una de estas secciones es producir el PDF.

Tejiendo el documento

Cuando el usuario termina con un documento, en R Markdown, entonces uno tiene que «entrelazar» su texto sin formato y codificar en su documento final. Para hacerlo, haga clic en el botón Tejer que se encuentra en la parte superior del panel de origen. Cuando uno lo haga, le pedirá que guarde el documento como un archivo RMD . hazlo Se puede ver un documento como este: 

Así que aquí se puede ver que el contenido del encabezado se transformó en un título, seguido de su nombre y la fecha. Los fragmentos de texto produjeron un encabezado de sección llamado «R Markdown» seguido de dos párrafos de texto. Después de esto, se puede ver el resumen del código R (coches) , lo que es más importante, seguido del resultado de ejecutar ese código. Este es uno de los grandes beneficios de R Markdown que representa los resultados en el código en línea.