Markdown 基本语法

简介 Introduction

Markdown 是一种轻量级标记语言，创始人为 John Gruber。它允许开发者使用易读易写的纯文本格式编写文档，然后转换成有效的 XHTML 或 HTML 文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

下面是 Markdown 的基本语法。

---

语法 Syntax

标题 Heading

标题是每篇文章必须的格式，在 Markdown 中，想要添加标题只需要在文字前加#即可。#的个数决定了标题的级数，一共六级。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

---

段落与换行 Paragraph

一个 Markdown 段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行。Markdown 的段落没有特殊的格式，可以直接编写文字。段落的换行是使用两个以上的空格加上回车。

---

区块引用 Quote

Markdown 标记区块引用是使用类似 Email 中>的引用方式。只需在每行的前面加上> ：

> 这是一段引用

效果：

这是一段引用

此外，区块引用可以嵌套，只要根据层级加上不同数量的>。

> 最外层
>> 第一层嵌套
>>> 第二层嵌套

效果：

最外层

第一层嵌套

第二层嵌套

---

列表 List

类似于 HTML，Markdown 支持有序列表和无序列表。列表允许嵌套。

无序列表使用*、+、- 作为列表标记：

* HTML
* CSS
* JavaScript

等同于：

+ HTML
+ CSS
+ JavaScript

也等同于：

- HTML
- CSS
- JavaScript

效果：

• HTML
• CSS
• JavaScript

有序列表使用数字后接一个英文句点：

1. Red
2. Blue
3. Green

效果：

1. Red
2. Blue
3. Green

值得注意的是，有序列表中列表标记的数字并不会决定输出结果的顺序。例如：

3. Red
1. Blue
6. Green

效果：

3. Red

4. Blue

5. Green

---

分隔线 Separation Line

可以在一行中使用三个以上的*、-、_ 来建立一个分隔线，行内不能有其他东西。例如：

***
*******
-----------
___________

---

字体 Font

• 删除线

如果段落上的文字要添加删除线，只需要在文字的两端加上两个波浪线 ~~ 即可：

~~这段文字加了删除线~~

效果：

这段文字加了删除线

• 斜体

如果要对某段文字增加倾斜效果，在文字的左右分别用一个*,例如：

*这段文字是斜体*

效果：

这段文字是斜体

• 加粗

如果要对某段文字加粗，在文字的左右分别用两个* ，例如：

**这段文字是粗体**

效果：

这段文字是粗体

• 斜体加粗

斜体和粗体的组合效果，在文字的左右分别用三个*,例如：

***这段文字是斜体加粗体***

效果：

这段文字是斜体加粗体

---

代码 Code

如果是段落上的一个函数或片段的代码可以用反引号把它包起来（`）：

`System.out.print()`

效果：

System.out.print()

也可以用**```**包裹一段代码，并指定一种语言(也可以不指定)：

```javascript
console.log('Hello World');
​```

效果：

console.log('Hello World');

---

超链接 Anchor

Markdown 超链接的语法：

[链接名称](链接地址) 或者 <链接地址>

例如：

[bing](https://www.bing.com) 或者 <https://www.bing.com>

效果： bing 或者 https://www.bing.com

---

图片 Image

Markdown 使用一种和链接很相似的语法来标记图片：

![图片的替代文字](图片路径)

• 开头一个感叹号！
• 接着一个方括号，里面是图片的替代文字
• 接着是一个普通括号，里面是图片的路径或者地址，最后还可以用引号包住并加上选择性的 ‘title’ 属性的文字。

---

表格 Table

Markdown 使用- 来分隔表头和其它行，用| 来分隔不用的单元格，语法：

|左对齐| 居中 |右对齐|
|:----|:---:|----:|
|单元格|单元格|单元格|
|单元格|单元格|单元格|

表格的对齐方式：
-: 右对齐
:- 左对齐（默认）
:-: 居中

左对齐	居中	右对齐
单元格	单元格	单元格
单元格	单元格	单元格
单元格	单元格	单元格