B.2 R Markdown

R과 Pandoc의 강력한 기능 덕분에 R Markdown 문서에서 쉽게 컴퓨팅을 수행하고 HTML / PDF / Word 문서, HTML5 / Beamer 슬라이드, 대시 보드 그리고 웹 사이트 등을 포함한 다양한 출력 형식으로 변환할 수 있습니다. R Markdown 문서는 일반적으로 YAML 메타 데이터 (선택 사항)와 문서 본문으로 구성됩니다. 2 장에서 문서 본문의 다양한 구성 요소를 작성하는 구문을 소개했으며 이 섹션에서는 YAML 메타 데이터에 대해 자세히 설명합니다.

R Markdown의 메타 데이터는 문서의 맨 처음에 작성될 수 있으며, 각각 세 개의 대시 ---로 시작하고 끝납니다. YAML 메타 데이터는 일반적으로 콜론(:)으로 구분된 tag-value 쌍으로 구성됩니다. 예를 들면 다음과 같습니다.

---
title: "An R Markdown Document"
author: "Yihui Xie"
---

문자 값의 경우 값에 특수 문자가 포함되지 않으면 따옴표를 생략할 수 있지만 문자 값으로 예상되는 경우 그것들을 따옴표로 묶는 것이 더 안전합니다.

문자 외에 또 다른 일반적인 유형의 값은 논리 값입니다. yes와 true는 모두 참을 의미하고 no/false는 거짓을 의미합니다.

link-citations: yes

값은 벡터가 될 수 있으며 벡터를 작성하는 두 가지 방법이 있습니다. 다음의 두 가지 방법은 동일합니다.

output: ["html_document", "word_document"]

output:
  - "html_document"
  - "word_document"

값은 값 목록일 수도 있습니다. 두 개의 공백으로 값을 들여 쓰기만 하면 됩니다.

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

값을 들여 쓰는 것을 잊는 것은 흔한 실수입니다. 예를 들어, 다음의 데이터는

output:
html_document:
toc: yes

다음과 같을 것으로 기대할 수 있지만

output:
  html_document:
    toc: yes

사실상 다음을 의미합니다.

output: null
html_document: null
toc: yes

R Markdown 출력 형식은 YAML 메타 데이터의 output 필드에 지정되어 있으며 가능한 옵션(예 :? rmarkdown::html_document 또는 ? bookdown::gitbook)에 대해서는 R 도움말 페이지를 참조해야 합니다. YAML에 있는 대부분의 다른 필드의 의미는 Pandoc 문서에서 찾을 수 있습니다.

rmarkdown 패키지는 다음과 같은 R Markdown 출력 형식을 제공합니다.

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

bookdown, tufte, articles, flexdashboard, revealjs 그리고 rmdformats 등을 포함한 다른 R 패키지에는 더 많은 가능한 출력 형식이 있습니다.