你可能已經(jīng)了解過輕量級標(biāo)記語言 Markdown。如果你是第一次接觸這個(gè)概念，請參考我們的 ??Markdown 指南??。概括來講，它是一種用于創(chuàng)建純文本文檔的簡單又高效的語言。

然而，Markdown 在制作詳細(xì)的報(bào)告或技術(shù)文件方面可能還不夠完善。

受益于 ??knitr?? 和 Pandoc 等軟件包，交互式文件格式 R Markdown 早在 2014 年就出現(xiàn)了。它將純文本與內(nèi)嵌的 R 代碼相結(jié)合，可以制作動態(tài)文件。

你可以使用 ??各種 IDE?? 和擴(kuò)展來創(chuàng)建 R Markdown 文檔，官方 IDE 為 RStudio。因此，在這篇文章中，我們將重點(diǎn)介紹使用 RStudio 學(xué)習(xí) R Markdown 語法。

??（假如你沒有了解過，）R 編程語言 是一種用于統(tǒng)計(jì)計(jì)算、圖形表示和報(bào)告的語言。

配置 RStudio

通過合適的配置，你可以很輕松地用 RStudio 來編寫 R Markdown。只需要安裝一個(gè)軟件包，就已經(jīng)完成了大部分的工作！

安裝 RStudio 后，在 “工具Tools” 菜單中選擇 “安裝軟件包Install Packages” 選項(xiàng)。

在 RStudio 的工具菜單下選擇安裝軟件包選項(xiàng)

在彈出的對話框中，搜索 “rmarkdown” 并安裝。

通過搜索并在新的軟件包安裝對話框中按下安裝按鈕來安裝 Rmarkdown 軟件包

?? 如果你想使用類似 Python 的代碼塊，你需要安裝額外的包。當(dāng)你想在你的文檔中包含這些包時(shí)，RStudio 會提示你安裝所需的包。

安裝完成后，你可以通過選擇 “文件File > 新建文件New File

從文件菜單中創(chuàng)建一個(gè)新的 RMarkdown 文檔

之后會提示你添加一些關(guān)于文件的信息（文件的元數(shù)據(jù)），把這些填上就可以了。

用 R Markdown 語法寫出標(biāo)題和其他細(xì)節(jié)

或者你可以創(chuàng)建一個(gè)空的文件從零開始。

RMarkdown 語法

由于它是 “加強(qiáng)版的 Markdown”，因此大多數(shù)語法與 Markdown 是一樣的。

它還有一些 Markdown 支持不完善的東西，比如表格、數(shù)學(xué)方程式、代碼塊等等。

下面是我們要介紹的內(nèi)容的概括：

YAML 頭

在一個(gè) R Markdown 文檔的頂部，有一個(gè) YAML 頭，被兩行 ??---?? 包圍。這個(gè)塊定義了文檔的最終樣式，通常包含一個(gè)標(biāo)題、作者、日期和你想輸出的文件類型。

支持的文件格式有三種：HTML、PDF 和 Word。

---
title: "Sample"
author: "It's FOSS"
date: "2023-02-08"
output: pdf_document
---

這可以在 RStudio 中設(shè)置新文件時(shí)添加，如上節(jié)所示。

標(biāo)題

在 R Markdown 中，有兩種方法指定標(biāo)題。我們可以使用 ??#?? 字符來表示不同級別的標(biāo)題，比如:

# Heading Level 1
## Heading Level 2
### Heading Level 3
#### Heading Level 4
##### Heading Level 5
###### Heading Level 6

也可以用 ??=?? 和 ??-?? 分別表示一級和二級標(biāo)題。

一級標(biāo)題
===============
二級標(biāo)題
---------------

rmarkdown 文件中不同等級的標(biāo)題

列表

有兩種列表，一種是無序列表，用點(diǎn)句符來表示：

* Item 1
* Item 2
    + Sub 1
    + Sub 2
* Item 3

另一種是有序列表，用數(shù)字來排序：

1. Item 1
2. Item 2
    + Sub 1
    + Sub 2
3. Item 3

有序和無序列表示例

段落中的文本格式

格式化文本有幾種方式。

你可以使用斜體或加粗來著重表示文本：

• 斜體：在文本前后各輸入一個(gè)星號或下劃線
• 加粗：在文本前后各輸入兩個(gè)星號或下劃線

*這里是斜體內(nèi)容*
_這里是斜體內(nèi)容_
**這里是加粗內(nèi)容**
__這里是加粗內(nèi)容__

?? 你可以閱讀我們的文章 ??Markdown 中怎么讓內(nèi)容變成加粗和斜體?? 來了解更多內(nèi)容。

如果你想使用上角標(biāo)，在想變成上角標(biāo)的內(nèi)容前后加上 ??^?? 符號。

普通文本內(nèi)容^上角標(biāo)^

如果你想對文本內(nèi)容加刪除線，在文本前后加 ??~~?? 符號。

~~被刪除的內(nèi)容~~

添加代碼塊

內(nèi)嵌代碼是 R Markdown 最主要的設(shè)計(jì)目的。我們有幾種添加代碼的方式。

添加普通代碼塊

如果你想添加一個(gè)代碼塊來與其他的文本進(jìn)行區(qū)分，可以使用下面的語法：

```
這里輸入你的代碼
```

你也可以嘗試 ??對添加的代碼進(jìn)行高亮顯示??。

如果你想添加代碼并將其輸出嵌入到文檔中，你可以在后面加上語言，并用大括號包裹：

```{語言}
這里輸入你的代碼
```

你可以用 ??`?? 符號來添加行內(nèi)代碼。

這里是 `行內(nèi)代碼`

它看起來是這樣的：

鏈接

如果想添加普通文本鏈接，把它粘貼到行內(nèi)就可以了。

https://itsfoss.com

添加超鏈接，使用下面的語法：

[文本內(nèi)容](URL 地址)

當(dāng)你想鏈接到本頁內(nèi)的某個(gè)錨點(diǎn)時(shí)，使用下面的語法：

[文本內(nèi)容](#錨點(diǎn)名稱)

表格

表格的語法與 Markdown 相似：

| 列表 | 列表 | 列表 |
| --- | --- | --- |
|表格項(xiàng)|表格項(xiàng)|表格項(xiàng)|
|表格項(xiàng)|表格項(xiàng)|表格項(xiàng)|

?? 還想了解更多？請閱讀我們的 ??用 Markdown 創(chuàng)建表格?? 指南。

圖片

添加圖片使用下面的語法：

![](http://example.com/logo.png)

或

![可選顯示文本](figures/img.png)

塊引用

RMarkdown 可以添加塊引用。在被引用的行或段落前添加 ??>??（大于號）。

這里是普通文本內(nèi)容。
> 這里是塊引用

?? 如果你想了解更多塊引用的內(nèi)容，請閱讀我們的 ??Markdown 引用?? 指南。

方程式

你可以用 RMarkdown 來添加方程式和展示復(fù)雜的 LaTex 方程式。

例如：

行內(nèi)方程式：$Equation$
展示方程式：$$Equation$$

在 R Markdown 文檔中添加方程式

章或頁水平分割線

使用三個(gè)以上星號或減號來添加章或頁水平分割線。

************
------------

你可以在行尾添加兩個(gè)以上的空格來添加人工行分割。

R Markdown 非常有用（備忘錄）

??R Markdown 備忘錄.pdf 下載文檔??

?? 你還知道其他關(guān)于 R Markdown 的內(nèi)容嗎？請?jiān)谙旅娴脑u論區(qū)告訴我們。