R Markdown 入门指南：在 RStudio 中创建可执行文档

【精选优质专栏推荐】

• 《AI 技术前沿》 —— 紧跟 AI 最新趋势与应用
• 《网络安全新手快速入门(附漏洞挖掘案例)》 —— 零基础安全入门必看
• 《BurpSuite 入门教程(附实战图文)》 —— 渗透测试必备工具详解
• 《网安渗透工具使用教程(全)》 —— 一站式工具手册
• 《CTF 新手入门实战教程》 —— 从题目讲解到实战技巧
• 《前后端项目开发(新手必知必会)》 —— 实战驱动快速上手

每个专栏均配有案例与图文讲解，循序渐进，适合新手与进阶学习者，欢迎订阅。

前言

人们喜欢使用 RStudio 的一个原因是因为 R Markdown。它使 RStudio 不仅是一个用于 R 编程的 IDE，还是一个笔记本，用户可以在其中记录他们的想法以及 R 代码和结果。在本文中，你将学习如何使用 R Markdown。具体来说，你将学习：

• 什么是 Markdown

• 如何在 RStudio 中使用 Markdown 创建技术文档

本文分为两部分：

• 新建 R Markdown 文档

• 如何使用 R Markdown

新建 R Markdown 文档

R Markdown 是一种将 R 代码、Markdown 文本和输出组合成单个文档的文件格式。它有助于生成包含代码和叙述性内容的报告。

R Markdown 文档只是纯文本文件，你可以使用任何文本编辑器进行编辑，包括 RStudio 和 Visual Studio Code。通常，R Markdown 文件使用“.Rmd”作为文件扩展名。R Markdown 文件可以转换为多种格式，包括 HTML 和 PDF。你可以在 RStudio 中轻松通过几次点击完成这些操作。你也可以在命令行中执行：

Rscript -e "rmarkdown::render('myfile.Rmd')"

这需要系统已安装 pandoc 命令行工具，以及 R 系统中的“rmarkdown”包。

install.packages('rmarkdown')

在 RStudio 中，你可以从其 Files 菜单轻松创建一个 R Markdown 文档：

并且如果你尚未安装所需的包，RStudio 会为你安装。然后，你将在一个对话框中被要求输入文档标题。你也可以在此对话框中选择使用 R Markdown 来制作演示文稿而不是文档。

之后，RStudio 会为你提供一个模板。你可以从这里开始编辑。

一旦你编辑完成 R Markdown 文档，你可以将其保存为纯文本的 *.Rmd 文件。你也可以将文档导出为 HTML 或 PDF。RStudio 将此称为“knit”。你可以在 Files 菜单或工具栏中执行此操作，如下所示：

默认模板渲染成 PDF 的效果如下：

如何使用 R Markdown

Markdown 是一种在纯文本中引入基本格式的方法。例如，可以用 ## 创建标题，用 * 标记无序列表。它易学易记，网上很容易找到“Markdown 速查表”。下面是一些常用 Markdown 语法示例：

# 一级标题

这是一个 Markdown 文档。

## 二级标题

你可以在文本中使用 **加粗** 或 *斜体*。你也可以创建
一个 [链接](https://xxx.com/)。

新段落需要用空行分隔。你还可以创建无序列表：
* 列表项 1
* 列表项 2
  * 列表项 2.1
* 列表项 3

或者有序列表：
1. 列表项
2. 列表项

Markdown 文件可以轻松转换为其他格式。例如，pandoc 是一个命令行工具，可将 Markdown 转换为 HTML 或 PDF。不过，R Markdown 特殊之处在于你可以在文件中嵌入可执行的 R 代码块（code chunk）。

代码块的语法如下：

```{r} # R 代码写在这里

在“knit”文档时，代码块会被执行。在生成的文档中，你会看到 R 源代码和其计算结果。如果只想显示结果而不显示代码，可添加参数 echo=FALSE：

```{r, echo=FALSE}# R 代码写在这里

代码块可用于创建表格、图表及其他可视化内容，也可执行统计分析。你可以用 print() 输出结果，但 R 会自动将返回的对象包含在最终文档中。下面是 RStudio 模板中的两个示例：

```{r cars, echo=TRUE}
summary(cars)

```{r pressure}
plot(pressure)

其中，summary() 返回表格，plot() 绘制图形。R Markdown 可以在生成的文档中正确显示两者。你也可以在 RStudio 中点击右侧小箭头运行代码块，即可立即在代码块下方看到结果。

R Markdown 是一个强大的工具，可用于创建各种类型的文档。你可以用它制作演示文稿、报告，甚至整本书。由于它允许将代码与说明文本并列展示，R Markdown 是一个向他人传达工作成果的多功能工具。

总结

在本文中，你学习了如何使用 R Markdown。具体来说，你学到：

• R Markdown 是一种文档类型，可以在 RStudio 中轻松编辑

• R Markdown 允许将 R 代码、代码输出和说明文本组合在同一个文档中