Markdown语法介绍
记录一下常用的markdown语法，方便查阅。 全文分为以下9个部分： 1.标题 2.区块引用 3.列表 4.代码块 5.分割线 6. 链接 7. 强调 8. 图片 9. 表格

除了以上的常用的基本语法外，Markdown还支持html，可以构成更高级的用法，本文暂不介绍。

1.标题
标题有两种标记格式： >Setext方式使用`=`标记一级标题； > 使用`-`标记二级标题 >Atx 方式使用多个`#`标记1级到6级标题

常用Atx方式

实例：
(1). Setext方式

1
2
3
4
一级标题
===============
二级标题
---------------

显示结果：
一级标题
===============
二级标题

(2). Atx方式

一个#代表一级标题，多少个#代表是多少级标题。
注意：#和标题名之间要有一个空格。

1
2
3
4
# 一级标题
## 二级标题
...
###### 六级标题

显示结果：

一级标题

二级标题

2.区块引用
Markdown 区块引用是在段落开头使用 `>` 符号 ，然后后面紧跟一个**空格**符号,在区块内可以嵌套的使用`>`以此来显示不同的层次,在引用的区块内可以使用其他的Markdown语法。

实例:

1
2
3
> 区块引用
> > 套娃
> > > 再套一层

显示结果:

区块引用

套娃

再套一层

3.列表
1. 无序列表可以使用 星号`*`，加号`+`, 减号 `-` 标记。 2. 有序列表使用数字后接一个英文点号，文字和序号之间仍然要有一个**空**_。

实例：

1
2
3
4
5
6
* Sunday
* Monday
* Tuesday
1. Sunday
2. Monday
3. Tuesday

显示结果:

  • Sunday
  • Monday
  • Tuesday
  1. Sunday
  2. Monday
  3. Tuesday

此外，列表也可以嵌套使用，使用时只需在子列表前添加四个空格，或一个制表符。

实例：

1
2
3
4
* top
	* second
		* third
	* second same

显示结果：

  • top
    • second
      • third
    • second same
4.代码块
与程序相关的原始码会有已经排版好的代码区块，通常这些区块我们并不希望它以一般段落文件的方式去排版，而是照原来的样子显示，因此使用代码块去显示这些代码。 Markdown有两种方式标记代码块：

  1. 缩进 4 个空格或是 1 个制表符
    实例：

    1
    2
    普通段落
    	代码区块

  2. 使用```包裹一段代码
    实例：

    1
    2
    def main(x):
            return x==0

    显示结果：

    1
    2
    def main(x):
           return x==0

    此外，可以使用反引号`来包括要强调的字符。
    实例：

    1
    `print`打印

    显示结果：
    print打印

5.分割线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。 实例： 
1
2
3
4
5
**************

-----------------

______________________

显示结果：

6. 链接
有两种方式，行内式和参考式,不论哪种方式都需要使用[中括号]将链接名包裹起来。

1.行内式
在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可。

实例：

1
This is my [website](https://llh-ustb.github.io/ "my blog").

显示结果：

This is my website.

2.参考式
参考式的链接是在链接文字的括号后面再接上另一个方括号，而在第二个方括号里面要填入用以辨识链接的标记。

实例:

1
2
my blog : [website][1]
[1]:https://llh-ustb.github.io

显示结果:

my blog : website

7. 强调
Markdown 使用星号`*`和底线`_`作为标记强调字词的符号。 实例： 
1
2
3
4
5
6
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___
显示结果：

斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本

8. 图片
Markdown 使用一种和链接很相似的语法来标记图片，同样也允许两种样式： 行内式和参考式,形式和链接的方式相似。

1.行内式
实例：

1
2
3
![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

2.参考式
实例：

1
2
![Alt text][id]
[id]: url/to/image  "Optional title attribute"
9. 表格
Markdown 制作表格使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行。 实例： 
1
2
3
4
|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |
显示结果：
表头 表头
单元格 单元格
单元格 单元格

此外，还可以设置对齐方式

  • -: 设置内容和标题栏居右对齐。
  • :- 设置内容和标题栏居左对齐。
  • :-: 设置内容和标题栏居中对齐。

实例：

1
2
3
4
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

显示结果：

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