Markdown 基本语法快速入门教程

朱雀 2021-03-29 11:11 633阅读 0赞

Markdown 允许人们直接用纯文本格式编写文档，然后转换成格式丰富的HTML页面，而且便于类似 svn、git 等版本管理工具的管理。下面是一些我经常会用到的 markdown 基本语法，掌握这些语法就能够应付日常的使用。

## 标题

H1-H6：在想要设置为标题的文字前面加 1-6 个 #

```
# 这是一级标题 H1
## 这是二级标题 H2
### 这是三级标题 H3
#### 这是四级标题 H4
##### 这是五级标题 H5
###### 这是六级标题 H6
```

注意：井号和文字之间需要加上空格。

## 正文/段落

### 字体

- **加粗**：`**这是加粗文字**`
- *倾斜*：`*这是斜体文字*`
- ~~删除线~~：`~~这是加删除线的文字~~`
- ***斜体加粗\***：`***这是斜体加粗的文字***`（上面3种自由组合）

其他内容可以通过直接使用 html 代码实现，但是兼容性不好，部分网站或工具可能不解析。

### 分割线

在一行中用三个以上的星号`***`来建立一个分隔线，行内不能有其他东西。效果如下：

------

### 段落缩进

这是一个缩进两个文字的段落：`  这是一个缩进两个文字的段落`

### 超链接

- 文字加链接：[蒲公英云](https://www.dandelioncloud.cn/)（`[蒲公英云](https://www.dandelioncloud.cn)`）
- 简单链接：[https://www.dandelioncloud.cn](https://www.dandelioncloud.cn/)（`<https://www.dandelioncloud.cn>`）
- 高级模式：类似参考文章，一个链接可以多次引用，如：

```
我使用 [Google][1] 进行学术搜索多一些，使用 [百度][2] 进行日常搜索多一些，很少使用 [Bing][3]。
我不能一边使用 [百度搜索][2] 一边骂他不如 [Google][1]，我们需要学会的是利用资源。

[1]: https://www.google.com/
[2]: https://www.baidu.com/
[3]: https://cn.bing.com/
```

**效果如下：**
我使用 [Google](https://www.google.com/) 进行学术搜索多一些，使用 [百度](https://www.baidu.com/) 进行日常搜索多一些，很少使用 [Bing](https://cn.bing.com/)。
我不能一边使用 [百度搜索](https://www.baidu.com/) 一边骂他不如 [Google](https://www.google.com/)，我们需要学会的是利用资源。

## 图片

- 行内形式：`![图片alt](图片地址 "图片title")`，图片alt就是显示在图片下面的文字，相当于对图片内容的解释，可以不填写。图片title是图片的标题，当鼠标移到图片上时显示的内容，部分网站或工具添加无效，title可选。
  如：`![博主头像](https://www.dandelioncloud.cn/head.jpg)`
- 高级模式：类似参考文章，一个图片可以多次引用，同“超链接”

```
![博主头像][4]

[4]:https://www.dandelioncloud.cn/head.jpg
```

两种模式的效果如下：
[![博主头像](/images/20210329/1617016081184.jpg)](/images/20210329/1617016081184.jpg)

## 表格

- 左对齐：`-` 或 `:-`
- 右对齐：`-:`
- 居中对齐：`: -:`
  **例如：**

```
| Left align | Right align | Center align |
|:-----------|------------:|:------------:|
| This       |        This |     This     |
| column     |      column |    column    |
| will       |        will |     will     |
| be         |          be |      be      |
| left       |       right |    center    |
| aligned    |     aligned |   aligned    |

第二行分割表头和内容。
- 有一个就行，为了对齐，多加了几个
```

**效果如下：**

| Left align | Right align | Center align |
| :--------- | ----------: | :----------: |
| This       |        This |     This     |
| column     |      column |    column    |
| will       |        will |     will     |
| be         |          be |      be      |
| left       |       right |    center    |
| aligned    |     aligned |   aligned    |

## 列表

### 无序列表

无序列表使用星号(`*`)作为列表标记，例如：

- 这是无序列表一：`* 这是无序列表一`
- 这是无序列表二：`* 这是无序列表二`
- 这是无序列表三：`* 这是无序列表三`

注意：星号和文字之间需要加上空格。

### 有序列表

有序列表使用数字并加上(`.`)来表示，例如：

1. 这是有序列表一：`1. 这是有序列表一`
2. 这是有序列表二：`2. 这是有序列表二`
3. 这是有序列表三：`3. 这是有序列表三`

注意：点号和文字之间需要加上空格。

### 列表嵌套

列表嵌套只需在子列表中的选项前面添加四个空格即可，如：

```
1. 第一项：
    * 第一项嵌套的第一个元素
    * 第一项嵌套的第二个元素
2. 第二项：
    * 第二项嵌套的第一个元素
    * 第二项嵌套的第二个元素
```