8 rmarkdown

rmarkdown就是用markdown格式写文档，但是可以直接运行其中的R语言代码块并且输出成html，pdf等不同格式。现在这些笔记就是用rmarkdown写的。最简单的写rmarkdown文档的方法就是直接新建一个文本文档把后缀名改成.Rmd，然后用rstudio打开用markdown格式写。rstudio会自动识别并且在上方工具栏出现一个knit按键。点一下就可以在rmd文件所在的位置生成一个输出文件并且自动打开。最方便的也是默认的输出形式就是html格式。因为pdf要借助latex渲染，如果要打中文还需要另外的设置。

8.1 R代码块

在rmarkdown文档中只要把r语言的代码放进下面形式的代码块中就可以直接运行并把代码和运行结果一起输出。

```{r}  
这里写代码  
```  

8.1.1 输出错误的代码

r代码如果出错就会无法渲染，如果希望即便出错也继续渲染需要在代码块里标注error=TRUE：

```{r error=TRUE}
一些会报错的代码
```

## Error in eval(expr, envir, enclos): object '一些会报错的代码' not found

8.1.2 hide source code

```{r echo=FALSE}
1 + 1
```

8.2 标题

如果不加rmarkdown文档没有标题，可以正常输入html文档，但是会有一条警告：

[WARNING] This document format requires a nonempty <title> element.
  Defaulting to 'playground.knit' as the title.
  To specify a title, use 'title' in metadata or --metadata title="...".

想去掉警告只要在rmarkdown文档的最开头输入

---
title: 你的题目
---

就好了。这一部分的格式是yaml，一种设置格式的代码形式。