Markdown - 基本语法

以下语法是在在MarkdownPad 2中选择 GitHub 风格 Markdown处理器 进行编辑，不同处理器语法可能会有小差别

标题

如下形式：

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

• 通过使用1到6个#符号加上标题内容生成标题，1到6个#符号分别对应一到六级标题，一级标题最大
• 正确使用标题可建立清晰的文章导航和文章脉络
• 二级标题会在下面自动添加一道较细的横线，如上述小标题就是二级标题
• 建议在#号后加一个空格，这是最标准的 Markdown 语法
• 等号及减号也可以进行标题的书写，不过只能书写二级标题，并且需要写在文字的下面，减号及等号的数量不会影响标题的基数

如下形式：

另一种二级标题内容表示
=========

另一种二级标题内容表示
---------

*注：建议还是使用#的方法

列表

无序列表

如下形式：

- 无序列表1内容
- 无序列表2内容
- 无序列表3内容

• 通过在符号“-”后加空格再加上内容进行生成，注意一定要在符号“-”后加一个空格，无序列表则在无序列表内容前面加一个小点，如本句则是一个无序列表的一条
• 按一次回车会自动添加一条列表内容，也即自动生成“-”符号，继续进行列表内容编辑，直到出现一行空行才退出这条列表内容编辑，也即按两次才退出列表内容编辑

有序列表

如下形式：

1. 有序列表1内容
2. 有序列表2内容
3. 有序列表3内容

通过在数字及符号“.”后加空格再加上内容进行生成，注意一定还需加上空格进行分割，则会生成带1. 2. 3.的有序列表项

列表层级套嵌

如下形式：

- 无序列表1
- 无序列表2
  - 无序列表2.1
     - 列表内容
     - 列表内容
- 无序列表3

通过在符号“-”前添加空格，则可控制有序、无序列表的层级，根据距左边空格数控制层级，空格数相同的属一个层级，也即在一列，前面会有相同层级标识图案。

引用

如下形式：

> 引用内容
> 接着上方引用内容

通过在符号“>”（大于号）后加上空格再加上所需引用内容进行生成，注意一定要加上空格，也直到出现一行空号退出引用内容编辑.

粗体与斜体

如下形式：

*需斜体显示内容*
**需粗体显示内容**
***需粗体加斜体显示内容***

粗体的使用是在需要加粗的文字前后各加两个“*”，斜体的使用则是在需要斜体的文字前后各加一个“*”，如果要使用粗体和斜体，那么就是在需要操作的文字前后各加三个“*”

链接与图片

如下形式：

[链接文字](链接地址)
！[图片描述](图片地址)

插入链接与插入图片的语法很像，区别在一个!号。

代码块

一段代码（用反引号）

如下形式：

“`代码类型
一大段代码
“`

通过使用3个“`”反引号括起所需展示的大段代码，以及在第一行反引号后面加上所展示代码类型名，如php、js等

一段代码（用Tab键）

如下形式：

`Tab`一行代码
`Tab`又一行代码
`Tab`又来一行代码
`空格``空格``空格``空格`这也能表示一行代码

• 用TAB键起始的段落，会被认为是代码块，也即4个空格起始的段落，1个Tab = 4个空格
• 只能保证一行代码的显示，每行代码前面都需要添加

一行代码

如下形式：

`想显示的一行代码`

通过使用1个“`”反引号的包裹在句子中显示一行代码。

表格

如下形式：

| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |

• 通过使用“|”符号分割表格的每格，以及“-”减号及“:”冒号表示对齐方式，减号的个数不限，但减号至少要有一个

  1. 若没有冒号或冒号在减号左边表示左对齐
  2. 减号两边都有表示中间对齐
  3. 若在减号右边表示右对齐

• 第一行表格每类的名字一定要有以及减号和冒号的一行也一定要有，第一行属性会自动黑体加粗，即第一行是表格属性名，第二行则是表格对齐方式，第三行是表格输出的第一行内容，第四行是第二行内容，以此类推

• 注意上述的冒号一定要是英文模式下输入，不可在中文形式，一定要注意

分割线与删除线

分割线

如下形式：

---
****
___

• 可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，同时需要在分隔线的上面空一行。

删除线

如下形式：

~~Mistaken text.~~

删除线的使用，在需要删除的文字前后各使用两个符号“~”。

反斜杠

可添加如下符号：

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

Markdown 可以利用反斜杠“\”来插入一些在语法中有其它意义的符号。