在这篇文章中,我们将探讨 R 编程语言中 Markdown 的相关概念。
我们将涵盖以下主题:
- R Markdown 简介
- Markdown 的优势
- 什么是 R Markdown?
- 为什么要使用 R Markdown?
- R Markdown 入门
R Markdown 简介
Markdown 是一种轻量级的标记语言,由 John Gruber 于 2004 年创建。如今,Markdown 已成为世界上最流行的标记语言之一。Markdown 文件的扩展名是 .md 或 .markdown。要编译 Markdown 文件,用户需要使用能够处理 Markdown 文件的应用程序,例如 Microsoft Word、Dillinger 等。这些应用程序利用 Markdown 解析器将 Markdown 文件转换为可打印的 HTML 代码。
Markdown 的优势
- 它主要用于在 StackOverflow、Github 等多个平台上编写格式化页面。
- 它不仅仅是为程序员准备的,因为人们可以使用 leanpub 等工具来编写电子书。
- 可转换为 PDF、HTML、docs 等多种格式。
- 可以使用 Github Pages、smallvictori.es 和 blot.im 等工具轻松将 Markdown 文件转换为网页。
什么是 R Markdown?
R Markdown 是一种生成完全可重现文档的方式,它可以在其中结合文本和代码。 这就是我们可以将内容制作成 项目符号、粗体、斜体、链接或运行行内 R 代码 的方式。尽管这些文档都以纯文本开始,但我们可以将它们渲染成 HTML 页面、PDF、Word 文档,甚至是幻灯片!用于表示格式(例如粗体或斜体)的符号兼容所有这些格式。
为什么要使用 R Markdown?
- 使用 R Markdown 的一个主要优势是可重现性。因为它可以简单地将文本和代码段组合在一个文档中,并且可以轻松地将介绍、假设、运行的代码、代码的结果以及结论全部整合在一起。分享你做了什么、为什么这样做以及结果如何变得非常容易,并且与你分享的人可以重新运行你的代码并获得与你相同的正确答案。这就是可重现性的含义。此外,你很少会从事一个需要数周才能完成的项目,而你希望能够看到很久以前做了什么,你可以准确地看到你运行了什么以及该代码的结果,R Markdown 文档允许你做到这一点。
- R Markdown 的另一个主要优势是,由于它是纯文本,它与版本控制系统 配合得非常好。跟踪提交之间发生的字符变化很简单;这与非纯文本的其他格式不同。
- R Markdown 的另一个实际优势是它非常易于使用。就像 R 中的所有内容一样,这个扩展功能来自一个 R 包“rmarkdown”。用户需要做的就是通过给出此命令来安装它:install.packages("rmarkdown")。
要创建 R Markdown 文档,在 R Studio 中,转到 File > New File > R Markdown。将出现以下窗口:
!Initiating an R Markdown file
如大家所见,上面的图像中填写了标题和作者,并将输出格式切换为 PDF。浏览此窗口以及左侧的选项卡,查看它可以输出的所有不同格式。完成后,点击 OK,应该会打开一个新窗口,其中包含关于 R Markdown 文件的一些说明。
!The default template for R Markdown files
R Markdown 文档有三个重要部分。
- Header(头部): 第一个是顶部的头部,由三个破折号包围。这是用户指定详细信息的地方,如标题、姓名、日期以及你想要输出的文档类型。如果用户之前在窗口中填写了空白,这些应该已经填写好了。
- Text(文本): 此外,在此页面上,用户可以看到文本部分,例如,一个部分以“## R Markdown”开头,当生成此文件的 PDF 时,该部分将呈现为文本,并且用户将学习的大多数格式通常适用于此部分。
- Code Chunk(代码块): 最后,用户将看到代码块。它们由三个反引号包围。这些是可以直接在文档中运行的 R 代码块,创建时这些代码的输出将包含在 PDF 中。查看每个部分如何工作的最简单方法是生成 PDF。
编织文档
当用户在 R Markdown 中完成文档后,必须将他的纯文本和代码“编织”成最终文档。为此,请点击位于源面板顶部的 Knit 按钮。这样做时,它会提示用户将文档保存为 RMD 文件。请照做。可以看到如下文档:
![T