R Markdown

rmarkdown 包可帮助你创建动态分析文档，它结合了代码、呈现的输出（如数字）以及散文文本。你带来了数据、代码和想法，而 R Markdown 会将你的内容呈现为经过打磨的文档，该文档可用于

• 在 RStudio IDE 中交互式地执行数据科学操作、

• 重现你的分析、

• 与他人合作并共享代码，以及

• 向他人传达你的研究成果。

R Markdown 文档可以呈现为多种输出格式，包括 HTML 文档、PDF、Word 文档、幻灯片等等，让你能够专注于内容，而 R Markdown 负责处理你的展示内容。

安装

安装 rmarkdown 包的最简单方法是在 RStudio IDE 中进行，但你不必明确安装或加载它，因为 RStudio 在需要时会自动执行这两步操作。还需要最新版本的 Pandoc（> = 1.12.3）；RStudio 也自动包含了这一点，因此如果你计划在 RStudio IDE 中使用 rmarkdown，则无需下载 Pandoc。

如果你想在 RStudio 外部使用 rmarkdown 包，则可以按照如下方式从 CRAN 安装该包

install.packages("rmarkdown")

如果你想使用 rmarkdown 包的开发版本（无论是否使用 RStudio），则可以通过 remotes 包从 GitHub 安装该包

remotes::install_github('rstudio/rmarkdown')

如果不使用 RStudio IDE，则需要安装最新版本的 Pandoc（> = 1.12.3）；请参阅 Pandoc 安装说明 以获得帮助。

用法

在 RStudio 中制作新的 R Markdown 文档的最简单方法。转至 文件 > 新建文件 > R Markdown。在新建文件向导中，你可以

• 提供文档标题（可选，但推荐）、
• 提供作者姓名（可选，但推荐）、
• 选择默认输出格式 - HTML 是创作的推荐格式，你可以随时切换输出格式（必需）、
• 单击 确定（必需）。

转到新 .Rmd 文件后，您应该会看到一些样板文本，其中包含代码块。使用 RStudio IDE 中的“Knit”按钮渲染文件并单击以下预览输出或使用键盘快捷键 Cmd/Ctrl + Shift + K。

您还可以删除 YAML 前置内容信息下面的所有文本，并通过以下方式填写您自己的 .Rmd 文件

• 添加代码块（键盘快捷方式：Ctrl + Alt + I；OS X：Cmd + Option + I），
• 使用 Markdown 格式 撰写散文，以及
• 单击 RStudio 中的 图标交互式运行每个代码块。

您还可以再次单击“Knit to HTML”以渲染带有所有代码块的完整文档。有关 R Markdown 入门方面的更多帮助，请参阅 R Markdown 网站 或使用此页面顶部的“入门”链接。

获取帮助

获取帮助的主要地方有 2 个

1. RStudio 社区 是一个友好的地方，可以询问有关 rmarkdown 及 R Markdown 系列包的任何问题。

2. Stack Overflow 是了解 rmarkdown 常用问题答案的绝佳资源。在您创建用于说明您问题的可重复示例后，这也是获取帮助的绝佳地方。