B.2 R Markdown

Gracias a la potencia de R y Pandoc, usted puede fácilmente hacer el cómputo de documentos en R Markdown, y convertirlos en una variedad de formatos de salida, incluyendo documentos de Word/HTML/PDF/, diapositivas HTML5/Beamer, dashboards, y sitios web, etc. Un documento en R Markdown, por lo general, consiste en metadatos YAML (opcional) y el cuerpo del documento. Se ha introducido la sintaxis para escribir diversos componentes del cuerpo del documento en el capítulo 2, y se explica más sobre los metadatos YAML en esa sección.

Los metadatos para R Markdown se puede escribir al principio de un documento, empezando y terminando con tres guiones ---, respectivamente. Los metadatos YAML consisten, generalmente, en pares de etiquetas de valor separados por dos puntos, por ejemplo,

---
title: "Un documento en R Markdown"
author: "Yihui Xie"
---

Para los valores de caracteres, es posible que omita las comillas cuando los valores no contienen caracteres especiales, pero es más seguro para citarlos si se espera que sean los valores de caracteres.

Además de los caracteres, otro tipo común de valores son valores lógicos. Tanto yes como true significan verdad, y no / false significan falso, por ejemplo,

link-citations: yes

Los valores pueden ser vectores, y hay dos formas de escribir vectores. Las dos formas siguientes son equivalentes:

output: ["html_document", "word_document"]

output:
  - "html_document"
  - "word_document"

Los valores también pueden ser listas de valores. Sólo tiene que aplicar sangría de dos espacios más a los valores, por ejemplo,

output:
  bookdown::gitbook:
    split_by: "section"
    split_bib: no

Es un error común olvidar sangrar los valores. Por ejemplo, los siguientes datos

output:
html_document:
toc: yes

significaría

output: null
html_document: null
toc: yes

en lugar de lo que probablemente habría esperado:

output:
  html_document:
    toc: yes

El formato de salida R Markdown se especifica en el campo output de los metadatos YAML, y hay que consultar las páginas de ayuda de R para las opciones posibles, por ejemplo,?rmarkdown::html_document, o ?bookdown::gitbook. Los significados de la mayoría de los otros campos en YAML se pueden encontrar en la documentación de Pandoc.

El paquete rmarkdown ha porporcionado estos formatos de salida R Markdown:

• beamer_presentation
• github_document
• html_document
• ioslides_presentation
• latex_document
• md_document
• odt_document
• pdf_document
• rtf_document
• slidy_presentation
• word_document

Hay muchos posibles formatos de salida en otros paquetes de R, incluyendo bookdown, tufte, rticles, flexdashboard, revealjs, y rmdformats, etc.