![R Markdown语法新手指南 图片[1]-R Markdown语法新手指南-不念博客](https://www.bunian.cn/wp-content/uploads/2023/03/image-46.jpeg)
你可能已经了解过轻量级标记语言 Markdown。如果你是第一次接触这个概念,请参考我们的 Markdown 指南。概括来讲,它是一种用于创建纯文本文档的简单又高效的语言。
然而,Markdown 在制作详细的报告或技术文件方面可能还不够完善。
受益于 knitr和 Pandoc 等软件包,交互式文件格式 R Markdown早在 2014 年就出现了。它将纯文本与内嵌的 R 代码相结合,可以制作动态文件。
你可以使用 各种 IDE和扩展来创建 R Markdown 文档,官方 IDE 为RStudio。因此,在这篇文章中,我们将重点介绍使用 RStudio 学习 R Markdown 语法。
💡(假如你没有了解过,)R 编程语言是一种用于统计计算、图形表示和报告的语言。
配置 RStudio
通过合适的配置,你可以很轻松地用 RStudio 来编写 R Markdown。只需要安装一个软件包,就已经完成了大部分的工作!
安装 RStudio 后,在 “工具Tools” 菜单中选择 “安装软件包Install Packages” 选项。
![R Markdown语法新手指南 图片[2]-R Markdown语法新手指南-不念博客](https://www.bunian.cn/wp-content/uploads/2023/03/image-70.png)
在弹出的对话框中,搜索 “rmarkdown” 并安装。
![R Markdown语法新手指南 图片[3]-R Markdown语法新手指南-不念博客](https://www.bunian.cn/wp-content/uploads/2023/03/image-69.png)
💡 如果你想使用类似 Python 的代码块,你需要安装额外的包。当你想在你的文档中包含这些包时,RStudio 会提示你安装所需的包。
安装完成后,你可以通过选择 “文件File > 新建文件New File > R Markdown” 来新建一个 R Markdown 文档。
![R Markdown语法新手指南 图片[4]-R Markdown语法新手指南-不念博客](https://www.bunian.cn/wp-content/uploads/2023/03/image-68.png)
之后会提示你添加一些关于文件的信息(文件的元数据),把这些填上就可以了。
![R Markdown语法新手指南 图片[5]-R Markdown语法新手指南-不念博客](https://www.bunian.cn/wp-content/uploads/2023/03/image-67.png)
或者你可以创建一个空的文件从零开始。
RMarkdown 语法
由于它是 “加强版的 Markdown”,因此大多数语法与 Markdown 是一样的。
它还有一些 Markdown 支持不完善的东西,比如表格、数学方程式、代码块等等。
下面是我们要介绍的内容的概括:
RMarkdown 块名 | 语法 |
---|---|
标题 | # 一级标题 ## 二级标题 ### 三级标题 一级标题 ======= 二级标题 ------- |
着重 | *斜体* _斜体_ **加粗** __加粗__ |
列表 | 无序列表:* 列表项 * 列表项 + 子项 + 子项 有序列表: 1. 列表项 2. 列表项 + 子项 + 子项 |
代码块 | 普通代码块:``` 这里写代码 ``` R 代码块: ```{r} R 代码 ``` 你也可以用其他的语言 行内 `代码` |
链接 | 普通链接:粘贴 URL 带标题的链接: [显示的文本](URL_地址) 跳转到锚点: [显示的文本](#锚点) |
表格 | | 列名 | 列名 | 列名 | | ------ | ------ | ------ | | 项内容 | 项内容 | 项内容 | | 项内容 | 项内容 | 项内容 | |
方程式 | 行内方程式 $Equations$ 展示方程式: $$Equations$$ |
图片 | 无标题: !(图片链接) 有标题:  |
引用块 | > 输入你引用的内容 |
其他 | 上角标:文本内容^上角标^ 章或页水平分割线 ========= 或---------- 行尾输入两个以上空格,即可添加人工行分割 |
YAML 头
在一个 R Markdown 文档的顶部,有一个 YAML 头,被两行 ---
包围。这个块定义了文档的最终样式,通常包含一个标题、作者、日期和你想输出的文件类型。
支持的文件格式有三种:HTML、PDF 和 Word。
---title: "Sample"author: "It's FOSS"date: "2023-02-08"output: pdf_document------ title: "Sample" author: "It's FOSS" date: "2023-02-08" output: pdf_document ------ title: "Sample" author: "It's FOSS" date: "2023-02-08" output: pdf_document ---
这可以在 RStudio 中设置新文件时添加,如上节所示。
标题
在 R Markdown 中,有两种方法指定标题。我们可以使用 #
字符来表示不同级别的标题,比如:
# Heading Level 1## Heading Level 2### Heading Level 3#### Heading Level 4##### Heading Level 5###### Heading Level 6# Heading Level 1 ## Heading Level 2 ### Heading Level 3 #### Heading Level 4 ##### Heading Level 5 ###### Heading Level 6# Heading Level 1 ## Heading Level 2 ### Heading Level 3 #### Heading Level 4 ##### Heading Level 5 ###### Heading Level 6
也可以用 =
和-
分别表示一级和二级标题。
一级标题===============二级标题---------------一级标题 =============== 二级标题 ---------------一级标题 =============== 二级标题 ---------------
![R Markdown语法新手指南 图片[6]-R Markdown语法新手指南-不念博客](https://www.bunian.cn/wp-content/uploads/2023/03/image-66.png)
列表
有两种列表,一种是无序列表,用点句符来表示:
* Item 1* Item 2+ Sub 1+ Sub 2* Item 3* Item 1 * Item 2 + Sub 1 + Sub 2 * Item 3* Item 1 * Item 2 + Sub 1 + Sub 2 * Item 3
另一种是有序列表,用数字来排序:
1. Item 12. Item 2+ Sub 1+ Sub 23. Item 31. Item 1 2. Item 2 + Sub 1 + Sub 2 3. Item 31. Item 1 2. Item 2 + Sub 1 + Sub 2 3. Item 3
![R Markdown语法新手指南 图片[7]-R Markdown语法新手指南-不念博客](https://www.bunian.cn/wp-content/uploads/2023/03/image-65.png)
段落中的文本格式
格式化文本有几种方式。
![R Markdown语法新手指南 图片[8]-R Markdown语法新手指南-不念博客](https://www.bunian.cn/wp-content/uploads/2023/03/image-64.png)
你可以使用斜体或加粗来着重表示文本:
- 斜体:在文本前后各输入一个星号或下划线
- 加粗:在文本前后各输入两个星号或下划线
*这里是斜体内容*_这里是斜体内容_**这里是加粗内容**__这里是加粗内容__*这里是斜体内容* _这里是斜体内容_ **这里是加粗内容** __这里是加粗内容__*这里是斜体内容* _这里是斜体内容_ **这里是加粗内容** __这里是加粗内容__
📋 你可以阅读我们的文章 Markdown 中怎么让内容变成加粗和斜体来了解更多内容。
如果你想使用上角标,在想变成上角标的内容前后加上 ^
符号。
普通文本内容^上角标^普通文本内容^上角标^普通文本内容^上角标^
如果你想对文本内容加删除线,在文本前后加 ~~
符号。
~~被删除的内容~~~~被删除的内容~~~~被删除的内容~~
![R Markdown语法新手指南 图片[9]-R Markdown语法新手指南-不念博客](https://www.bunian.cn/wp-content/uploads/2023/03/image-63.png)
添加代码块
内嵌代码是 R Markdown 最主要的设计目的。我们有几种添加代码的方式。
添加普通代码块
如果你想添加一个代码块来与其他的文本进行区分,可以使用下面的语法:
```这里输入你的代码`````` 这里输入你的代码 `````` 这里输入你的代码 ```
你也可以尝试 对添加的代码进行高亮显示。
如果你想添加代码并将其输出嵌入到文档中,你可以在后面加上语言,并用大括号包裹:
```{语言}这里输入你的代码``````{语言} 这里输入你的代码 ``````{语言} 这里输入你的代码 ```
你可以用 `
符号来添加行内代码。
这里是 `行内代码`这里是 `行内代码`这里是 `行内代码`
它看起来是这样的:
![R Markdown语法新手指南 图片[10]-R Markdown语法新手指南-不念博客](https://www.bunian.cn/wp-content/uploads/2023/03/image-62.png)
链接
如果想添加普通文本链接,把它粘贴到行内就可以了。
https://itsfoss.comhttps://itsfoss.comhttps://itsfoss.com
添加超链接,使用下面的语法:
[文本内容](URL 地址)[文本内容](URL 地址)[文本内容](URL 地址)
当你想链接到本页内的某个锚点时,使用下面的语法:
[文本内容](#锚点名称)[文本内容](#锚点名称)[文本内容](#锚点名称)
![R Markdown语法新手指南 图片[11]-R Markdown语法新手指南-不念博客](https://www.bunian.cn/wp-content/uploads/2023/03/image-61.png)
表格
表格的语法与 Markdown 相似:
| 列表 | 列表 | 列表 || --- | --- | --- ||表格项|表格项|表格项||表格项|表格项|表格项|| 列表 | 列表 | 列表 | | --- | --- | --- | |表格项|表格项|表格项| |表格项|表格项|表格项|| 列表 | 列表 | 列表 | | --- | --- | --- | |表格项|表格项|表格项| |表格项|表格项|表格项|
![R Markdown语法新手指南 图片[12]-R Markdown语法新手指南-不念博客](https://www.bunian.cn/wp-content/uploads/2023/03/image-60.png)
📋 还想了解更多?请阅读我们的 用 Markdown 创建表格指南。
图片
添加图片使用下面的语法:
!(http://example.com/logo.png)!(http://example.com/logo.png)!(http://example.com/logo.png)
或

![R Markdown语法新手指南 图片[13]-R Markdown语法新手指南-不念博客](https://www.bunian.cn/wp-content/uploads/2023/03/image-59.png)
块引用
RMarkdown 可以添加块引用。在被引用的行或段落前添加 >
(大于号)。
这里是普通文本内容。> 这里是块引用这里是普通文本内容。 > 这里是块引用这里是普通文本内容。 > 这里是块引用
![R Markdown语法新手指南 图片[14]-R Markdown语法新手指南-不念博客](https://www.bunian.cn/wp-content/uploads/2023/03/image-58.png)
📋 如果你想了解更多块引用的内容,请阅读我们的 Markdown 引用指南。
方程式
你可以用 RMarkdown 来添加方程式和展示复杂的 LaTex 方程式。
例如:
行内方程式:$Equation$展示方程式:$$Equation$$行内方程式:$Equation$ 展示方程式:$$Equation$$行内方程式:$Equation$ 展示方程式:$$Equation$$
![R Markdown语法新手指南 图片[15]-R Markdown语法新手指南-不念博客](https://www.bunian.cn/wp-content/uploads/2023/03/image-58.png)
章或页水平分割线
使用三个以上星号或减号来添加章或页水平分割线。
************------------************ ------------************ ------------
你可以在行尾添加两个以上的空格来添加人工行分割。
R Markdown 非常有用(备忘录)
![R Markdown语法新手指南 图片[16]-R Markdown语法新手指南-不念博客](https://www.bunian.cn/wp-content/uploads/2023/03/image-71.png)
R Markdown 备忘录.pdf 下载文档
💬 你还知道其他关于 R Markdown 的内容吗?请在下面的评论区告诉我们。