8.1 R Markdown 문서

R Markdown은 RStudio에서 완벽하게 지원된다. Markdown에서 메모를 작성할 수 있을 뿐 만 아니라 포함된 코드를 블록 단위로 실행하여 R Markdown 문서에 실시간으로 바로 표시할 수도 있다. 새 R Markdown 문서를 만들려면 RStudio 메뉴 모음으로 이동하여 그림 8.1과 같이 “File,” “New File” 그리고 “R Markdown”을 클릭한다.

그림 8.1: 새 R 마크다운 문서 추가

그림 8.2에 표시된 대화 상자에 생성되는 문서의 유형을 결정하는 옵션이 표시된다.

그림 8.2: R 마크다운 옵션

여기에서 HTML 또는 PDF 문서를 원하는지 지정한다. 실험할 수 있는 덜 사용되는 다른 형식 유형도 있지만 일반적으로 사람들은 PDF 또는 HTML 보고서를 사용한다. RStudio는 그림 8.3과 유사한 템플릿 텍스트로 R Markdown 문서를 자동으로 생성한다.

그림 8.3: R 마크다운 문서

위의 R Markdown 문서에는 4 개의 개별 섹션이 있다. 처음 여섯 줄은 일명 YAML(Yet Another Markup Language)이라고 한다.

---
title: "Life Expectancy"
author: "Dae Ho Kim"
date: "2021 1 3"
output: html_document
---

이 YAML markup은 출력 형식의 유형 및 작성자 이름, 기본적으로 대화 상자에 입력한 내용을 지정한다.

회색으로 강조 표시된 다음 세 줄은 R Markdown 출력을 렌더링하는 데 사용되는 패키지 인 knitr에 필요한 옵션을 설정하는 데 사용된다.

​```{r setup, include=FALSE}
knitr::opts_chunk$set(echo = TRUE)
​```

세 개의 백틱(```)과 중괄호({})가 있는 첫 번째 줄은 주의를 기울여야 한다. 이것은 문서에 R 코드를 포함할 수 있도록 Markdown 코드를 이스케이프하는 데 사용하는 표기법이다.

형식은 대략 세 개의 백틱, 여는 중괄호, 문자 r 다음에 몇 가지 옵션 그리고 끝 중괄호이다.

위 코드에서 setup은 단순히 레이블이고 include = FALSE는 코드가 실행되지만 R Markdown 출력에 표시되지 않음을 의미한다.

다음 몇 줄의 코드는 기본적인 Markdown이다.

## R Markdown

This is an R Markdown document. Markdown is a simple formatting syntax for authoring HTML, PDF, and
MS Word documents. For more details on using R Markdown see <http://rmarkdown.rstudio.com>.

여기에서 데이터 분석에 대한 결과, 절차 그리고 설명을 작성한다. 시작 부분에 있는 두 개의 숫자 기호는 “제목 2”를 의미하며 형식화는 출력 문서에 이를 반영한다. 모든 일반 Markdown 기능을 사용할 수도 있다. Markdown의 작성자는 https://daringfireball.net/projects/markdown에 사용할 수 있는 서식 지정 기능을 문서화하고 있다.

나머지 코드는 또 다른 R 청크(chunk)이다. 이번에는 코드가 플롯을 생성하고 R Markdown 출력에 포함된다.

​```{r cars}
summary(cars)
​```

내장된 cars 데이터 세트의 요약이 출력된다. 다음에 다룰 예제에서 이것이 어떻게 보이는지 예제를 통해 살펴 볼 것이다.