人们喜欢使用 RStudio 进行工作的原因之一是 R Markdown。这使得 RStudio 不仅是一个用于 R 编程的 IDE，还可以作为一个记事本，在其中放入他们的想法、R 代码和结果。在本帖中，您将学习如何使用 R Markdown。具体来说，您将学习：
- 什么是 Markdown
- 如何在 RStudio 中使用 Markdown 创建技术文档
让我们开始吧。
R Markdown 使用入门
摄影： Khadeeja Yasser。部分权利保留。
概述
这篇文章分为两部分：
- 开始一个新的 R Markdown 文档
- 如何使用 R Markdown
开始一个新的 R Markdown 文档
R Markdown 是一种文件格式，它将 R 代码、Markdown 文本和输出结合到一个文档中。它可以帮助您生成包含代码和叙述的报告。
R Markdown 文档只是纯文本文件，您可以使用任何文本编辑器对其进行编辑，包括 RStudio 和 Visual Studio Code。通常，R Markdown 文件的文件名扩展名为“.Rmd”。R Markdown 文件可以转换为多种格式，包括 HTML 和 PDF。在 RStudio 中，只需点击几下即可轻松完成。您也可以在命令行中完成
|
1 |
Rscript -e "rmarkdown::render(‘myfile.Rmd')" |
这将需要您的系统安装了 `pandoc` 命令行工具，以及您的 R 系统中安装了“`rmarkdown`”包。
|
1 |
install.packages('rmarkdown') |
在 RStudio 中，您可以轻松地从其“文件”菜单开始一个 R Markdown 文档
如果您尚未安装，RStudio 将会安装所需的包。然后，您将在对话框中被要求输入文档标题。您也可以在此对话框中选择使用 R Markdown 进行演示文稿而不是文档。
之后，RStudio 将为您提供一个模板。您可以从这里开始编辑。
完成编辑 R Markdown 文档后，您可以将其另存为纯文本 `*.Rmd` 文件。您也可以将文档导出为 HTML 或 PDF。RStudio 将此称为“knit”。您可以从“文件”菜单或工具栏中完成此操作，如下所示：
默认模板渲染成 PDF 的效果如下：
如何使用 R Markdown
Markdown 是一种在纯文本中引入基本格式的方法。例如，您可以使用 `##` 创建标题，用 `*` 标记项目符号列表。它易于学习和记忆。您可以在互联网上轻松找到“Markdown 备忘单”。以下是一些常用 Markdown 语法的示例：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
# 一级标题 This is a markdown document. ## 二级标题 You can make **bold** or *italic* in text. You can also create a [link](https://machinelearning.org.cn/). New paragraph needs a blank line to separate. And you can create a bulleted list: * list item 1 * list item 2 * list item 2.1 * list item 3 or a numbered list: 1. list item 2. list item |
Markdown 文件可以轻松转换为其他格式。例如，`pandoc` 是将文件转换为 HTML 和 PDF 的命令行工具。然而，R Markdown 的特殊之处在于您还可以将可执行的 R 代码包含在 Markdown 文件中，称为“代码块”。
代码块的语法如下：
|
1 2 3 |
```{r} # r 代码在此处 ``` |
代码块在您“knit”您的 R Markdown 文档时进行计算。在 knit 后的文档中，您将看到 R 源代码以及计算出的输出。如果您只想看输出而不看生成它的代码，则添加 `echo=FALSE` 参数，如下所示：
|
1 2 3 |
```{r, echo=FALSE} # r 代码在此处 ``` |
您可以使用代码块创建表格、图表和其他可视化，以及执行统计分析。您可以使用 `print()` 函数来创建输出。但 R 很智能，只需返回一个 R 数据结构就足以包含在 knit 后的文档中。以下是 RStudio 模板中的两个示例：
|
1 2 3 4 5 6 7 |
```{r cars, echo = TRUE} summary(cars) ``` ```{r pressure} plot(pressure) ``` |
其中 `summary()` 返回一个表格，`plot()` 创建一个图。R Markdown 可以在 knit 后的文档中正确显示两者。或者，您也可以通过单击指向右边的小箭头立即在 RStudio 中看到结果，这意味着运行该特定代码块。运行后，您应该会在代码块下方看到插入的结果。
结果将在 RStudio 中的代码块下方显示
R Markdown 是一个强大的工具，可用于创建各种文档。您可以使用它来创建演示文稿、报告，甚至书籍。由于它允许您将代码和叙述并列，因此它是与他人沟通工作的多功能工具。
进一步阅读
以下是一些帮助您了解更多的资源：
备忘单
在线教程
- RStudio 的 R Markdown：https://rmarkdown.rstudio.com/lesson-1.html
书籍
- Yihui Xie、J. J. Allaire、Garrett Grolemund 的《R Markdown: The Definitive Guide》：https://bookdown.org/yihui/rmarkdown/
总结
在本帖中，您学习了如何使用 R Markdown。具体来说，您学习了：
- R Markdown 是一种文档类型，您可以使用 RStudio 轻松编辑
- R Markdown 允许您将 R 代码、其输出和叙述性文本合并到一个文档中
暂无评论。