R 마크다운 사용법

# R 마크다운 사용법

R 마크다운(R Markdown)은 R을 사용한 데이터 분석 보고서를 쉽고 간편하게 작성할 수 있게 해주는 도구입니다. R 코드와 텍스트를 통합하여 문서, 보고서, 슬라이드, 웹사이트 등을 만들 수 있으며, 다양한 출력 형식을 지원합니다. 아래에서는 R 마크다운의 기본 사용법을 상세히 설명합니다.

## R 마크다운의 기본 구조

R 마크다운 파일은 `.Rmd` 확장자를 가지며, 기본 구조는 세 부분으로 나뉩니다: YAML 헤더, 본문(텍스트와 R 코드 청크), 그리고 출력 형식입니다.

### 1. YAML 헤더

문서의 메타데이터를 정의하는 부분입니다. YAML 헤더는 문서의 제목, 저자, 날짜, 출력 형식 등을 지정합니다. YAML 헤더는 `---`로 시작하고 끝납니다.

```yaml
---
title: "R 마크다운 사용법"
author: "작성자 이름"
date: "2024-06-06"
output: html_document
---
```

### 2. 본문

본문은 텍스트와 R 코드 청크로 구성됩니다. 텍스트는 마크다운 문법을 사용하여 작성하며, 코드 청크는 ```{r} ```로 시작하고 ```으로 끝납니다.

#### 텍스트

마크다운 문법을 사용하여 텍스트를 작성할 수 있습니다.

- **헤더**: `#`, `##`, `###` 등의 기호를 사용하여 제목과 소제목을 작성합니다.
- **강조**: `**굵게**` 또는 `__굵게__`, `*기울임*` 또는 `_기울임_` 등으로 텍스트를 강조할 수 있습니다.
- **리스트**: `-`, `*` 또는 숫자를 사용하여 목록을 만듭니다.

예시:
```markdown
# R 마크다운 사용법

## 텍스트 작성

- **굵은 글씨**
- *기울임 글씨*
- 순서 없는 목록
  - 항목 1
  - 항목 2
- 순서 있는 목록
  1. 첫 번째 항목
  2. 두 번째 항목
```

#### 코드 청크

코드 청크는 ```{r} ```로 시작하고 ```으로 끝납니다. 코드 청크 안에 R 코드를 작성하면, 이를 실행하여 결과를 문서에 포함할 수 있습니다.

예시:
```markdown
```{r}
# 간단한 R 코드 예제
summary(cars)
plot(cars)
```
```

코드 청크에는 여러 가지 옵션을 설정할 수 있습니다. 예를 들어, 코드와 결과를 숨기거나, 코드만 숨기고 결과만 보이게 할 수 있습니다.

```markdown
```{r, echo=FALSE}
# 코드를 숨기고 결과만 보이게 함
summary(cars)
```

```{r, results='hide'}
# 결과를 숨기고 코드만 보이게 함
plot(cars)
```
```

### 3. 출력 형식

YAML 헤더에서 `output` 옵션을 사용하여 문서의 출력 형식을 지정할 수 있습니다. R 마크다운은 다양한 출력 형식을 지원합니다.

- **HTML 문서**: `output: html_document`
- **PDF 문서**: `output: pdf_document`
- **워드 문서**: `output: word_document`
- **슬라이드**: `output: ioslides_presentation` 또는 `output: beamer_presentation`

예시:
```yaml
---
title: "R 마크다운 사용법"
author: "작성자 이름"
date: "2024-06-06"
output:
  html_document:
    theme: cerulean
  pdf_document:
    toc: true
  word_document: default
---
```

## R 마크다운의 기본 기능

### 1. 텍스트 포맷팅

마크다운 문법을 사용하여 텍스트를 다양한 형식으로 작성할 수 있습니다.

- **링크**: `[링크 텍스트](URL)` 형식으로 작성합니다.
- **이미지**: `` 형식으로 작성합니다.
- **표**: 파이프(`|`)와 하이픈(`-`)을 사용하여 표를 작성합니다.

예시:
```markdown
[R 마크다운 사용법](https://5bluewhale.tistory.com/7)


| 헤더1 | 헤더2 |
|-------|-------|
| 셀1   | 셀2   |
| 셀3   | 셀4   |
```

### 2. 수학식 작성

LaTeX 수식을 사용하여 수학식을 작성할 수 있습니다.

- 인라인 수식: `$ 수식 $`
- 블록 수식: `$$ 수식 $$`

예시:
```markdown
인라인 수식 예: $E = mc^2$

블록 수식 예:
$$
E = mc^2
$$
```

### 3. 시각화

R 마크다운을 사용하면 데이터 시각화를 문서에 포함할 수 있습니다. `ggplot2` 패키지를 사용한 예시는 다음과 같습니다.

예시:
```markdown
```{r, echo=FALSE}
library(ggplot2)
ggplot(data = mtcars, aes(x = wt, y = mpg)) +
  geom_point() +
  labs(title = "산점도", x = "Weight", y = "Miles per Gallon")
```
```

## R 마크다운 사용 예시

R 마크다운 파일의 전체 예시는 다음과 같습니다.

```markdown
---
title: "R 마크다운 사용법"
author: "작성자 이름"
date: "2024-06-06"
output: html_document
---

# R 마크다운 소개

R 마크다운은 **R 코드**와 *텍스트*를 통합하여 문서를 작성할 수 있는 도구입니다. 아래는 간단한 예제입니다.

## 데이터 요약

`cars` 데이터셋의 요약 통계입니다.

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

## 데이터 시각화

`cars` 데이터셋의 산점도입니다.

```{r}
plot(cars)
```

## 추가 정보

[R 마크다운 사용법](https://5bluewhale.tistory.com/7)


| 변수 | 설명        |
|------|-------------|
| speed| 자동차 속도 |
| dist | 제동 거리   |
```

이 예시는 R 마크다운 문서가 어떻게 구성되고 작동하는지를 보여줍니다. 실제 프로젝트나 보고서 작성 시에는 이와 같은 구조를 응용하여 필요한 내용을 포함시키면 됩니다.

## 결론

R 마크다운은 데이터 분석과 보고서를 통합하여 작성할 수 있는 강력한 도구입니다. R 코드와 마크다운 문법을 결합하여 다양한 형식의 문서를 생성할 수 있으며, 이를 통해 분석 결과를 효율적으로 전달할 수 있습니다. R 마크다운을 잘 활용하면 데이터 분석 작업을 보다 체계적이고 효율적으로 수행할 수 있습니다.