本文主要介绍 Markdown 的基础语法。
本文主要介绍 Markdown 的基础语法，Markdown 扩展语法请参考 3. 高级语法 。
一、标题
要创建标题只需使用井号 # 开头，井号的数量对应标题的级别（共有 1 - 6 级标题）。一级标题对应一个 #，二级标题对应两个#，以此类推。比如你想要创建一个 `` 的标题，则可通过三个# 开头：### 三级标题 ，具体如下：
| Markdown | HTML | 渲染结果 |
|---|---|---|
# 一级标题 |
<h1>一级标题</h1> |
一级标题 |
## 二级标题 |
<h2>二级标题</h2> |
二级标题 |
### 三级标题 |
<h3>三级标题</h3> |
三级标题 |
#### 四级标题 |
<h4>四级标题</h4> |
四级标题 |
###### 五级标题 |
<h5>五级标题</h5> |
五级标题 |
####### 六级标题 |
<h6>六级标题</h6> |
六级标题 |
Markdown 段落没有特殊的格式，使用空行分隔文本即可。
二、段落
使用空行分隔文本即可。
- 段落开头不要使用空格或者制表符（
\t即 Tab 键）来缩进，否则可能会被当做代码块渲染。 - 中文传统排版上段落开头有着“空两格”的习惯，可以使用全角空格
 。科技领域的文章排版建议不要空两格，段落居左对齐较好。
三、字体
Markdown 可以使用以下几种字体：
| Markdown | 渲染结果 |
|---|---|
| **粗体** | 粗体 |
| __粗体__ | 粗体 |
| *斜体* | 斜体 |
| _斜体_ | 斜体 |
| ***粗斜体*** | 粗斜体 |
| ___粗斜体___ | 粗斜体 |
四、区块引用
Markdown 区块引用是在段落开头使用> 符号 ，然后后面紧跟一个空格 ：
> 明天
> 将以绿色的脚步
> 来临
结果：
明天 将以绿色的脚步 来临
区块引用内分段
如果需要分段的话需要可以在分段空行前加上一个 >。
> 明天
> 将以绿色的脚步
>
> 来临
结果：
明天 将以绿色的脚步
来临
嵌套块引用
块引用可以嵌套使用，在段落前添加两个大于号 >> 表示两层嵌套。
> 区块引用段落
>
>> 嵌套的区块引用段落
结果：
区块引用段落
嵌套的区块引用段落
块引用包含其他元素
> ### 标题是叶子块元素
>
> * 列表项一是容器块元素
> * 列表项二也是容器块元素
>
> **加粗**和*强调*是行级元素。
结果：
标题是叶子块元素
- 列表项一是容器块元素
- 列表项二也是容器块元素
加粗和强调是行级元素。
五、列表
列表分为有序列表和无序列表。
无序列表
使用星号 *、加号 + 或是减号 - 作为列表标记，这些标记后面要添加一个空格，然后再填写内容：
* 第一行
* 第二行
* 第三行
+ 第一行
+ 第二行
+ 第三行
- 第一行
- 第二行
- 第三行
结果：
- 第一行
- 第二行
- 第三行
- 第一行
- 第二行
- 第三行
- 第一行
- 第二行
- 第三行
有序列表
通过阿拉伯数字后跟 . 或者 ) 来创建，数字不必递增连续。
1. 第一行
2. 第二行
3. 第三行
1) 第一行
2) 第二行
3) 第三行
结果：
- 第一行
- 第二行
- 第三行
- 第一行
- 第二行
- 第三行
列表项包含其他元素
列表项可以包含其他任意元素，比如段落、块引用、代码块、图片等。使用要点是待包含元素的起始字符要和列表项起始内容“对齐”。
列表项包含段落
* 列表项一
* 列表项二第一段
这是第二段(这里要和下面文字对齐)
* 列表项三
结果：
- 列表项一
- 列表项二第一段
这是第二段(这里要和下面文字对齐)
- 列表项三
列表项包含块引用
* 列表项一
* 列表项二第一段
> 第二段是块引用
* 列表项三
结果：
- 列表项一
- 列表项二第一段
第二段是块引用
- 列表项三
列表项包含代码块
* 列表项一
* 列表项二第一段
```
这里是代码块
echo 你好，世界！
* 列表项三
结果：
- 列表项一
- 列表项二第一段
这里是代码块
echo 你好，世界！
- 列表项三
列表项包含图片
* 列表项一
* 列表项二第一段
* 列表项三
结果：
- 列表项一
- 列表项二第一段
- 列表项三
六、代码
代码片段可以用反引号 ` 包起来。
`System.out.println();`
结果
System.out.println();
转义反引号
如果你需要显示反引号，可以用转义符 \ 来对反引号进行转义。
代码块
使用围栏代码块语法来排版代码块，即使用 ``` 来包裹代码块，并且指定语法高亮语言：
<html>
<head>
</head>
</html>
七、分隔线
通过大于等于三个星号 ***、短横线 --- 或者下划线 ___ 来创建分隔线。
***
---
___
下一节：有些时候基础语法不足以满足复杂一些的排版需求，这时候就需要使用扩展语法了。本文主要介绍 Markdown 的扩展语法。