Markdown常用语法说明

　　Markdown是一种轻量级标记语言。其原理也很简单，就是在我们编写纯文本的文档时，加入一些简单的语法标记，然后通过这些标记转换成有效的XHTML（或者HTML）格式文档。现在很多编辑器都支持Markdown语法进行文档书写，要注意的是，虽然预览效果整体上都差不多，但不同的编辑器在预览效果上会有一些差异，有些编辑器还支持自定义效果。Typora应该是最常用的（），下面的效果也是以Typora效果为例。来看看比较常用的一些语法。

 

一、标题

方法1：一般使用' # '的个数 + 空格，来标识几级标题。共 6 级标题，再多不识别。

# h1

## h2

### h3

#### h4

##### h5

###### h6

注：一级标题，二级标题会默认带一个分隔线

 

方法2：大于1个的' = '、' - '分别表示一级标题、二级标题，效果跟上面一样。

h1

===

h2

---

 

二、强调

斜体：*文本1* 或 _文本1_

加粗：**文本2** 或 __文本2__

加粗斜体：***文本3*** 或 ___文本3___

 

三、删除线

用2个波浪号标识。

~~这是一条删除线~~

 

四、分隔线

至少3个' * '或' + '或' _ '来标识，中间有空格不连续也可以，效果都是一样的。

***

* * *

---

- - -

___

_ _ _

 

 

五、代码块

（1）单行，首尾使用1个' ` '来标识。

使用`Tab`键。

 

（2）多行，首尾使用3个' ` '来标识。

```注释

public static void main(String[] args) {

System.out.println("Test");

}

```

 

六、列表

（1）有序列表，数字 + ' . ' + 空格。

1. xxxxx

2. xxxxx

3. xxxxx

 

 

（2）无序列表，' - '或' + '或' * ' + 空格。也支持嵌套，在前面使用 tab 或 空格 来缩进，来控制列表的层级关系。

- x

- xx

- xxx

 

+ x

+ xx

+ xxx

 

* xxx

* xxx

  * xxxx

    * xxxxx

* xxx

 

 

七、引用

使用' > '来标识，可以嵌套引用，理论上无限嵌套。

> 一级

>> 二级

>>> 三级

>>>> 四级

 

 

八、链接

方法1：行内式，使用中括号标识页面文字，小括号标识链接地址，还可加空格带字符串说明。

[百度地址](https://www.baidu.com/)

[百度地址](https://www.baidu.com/ '我是说明')

 

 

方法2：参考式，使用中括号标识页面文字，再跟一个中括号标记变量名称，然后可以在文章任意地方对变量进行定义。

[百度地址][id]

[id]: http://www.baidu.com/ "我是说明"

 

参考式的简写方式，即省略变量名称，定义的时候，直接用页面文字进行关联。

[百度地址][]

[百度地址]: http://www.baidu.com/ "我是说明"

 

九、图片

与链接一样，只需在前面再加个感叹号，也可以使用行内式和参数式。


 

十、表格

方法1：通过竖线分割出表格，冒号代表对齐方式，靠左标识左对齐，靠右标识右对齐，两边都有标识居中对齐。

|name|age|sex|

|:-:|-:|:-|

|tom|5|男|

|jerry|3|女|

 

 

方法2：其实跟方法1类似，更简洁，省略了两侧的竖线，不过部分编辑器识别起来不太顺利。

name|age

-|-

tom|5

lucy|3

 

 

十一、转义

通过反斜杠转义，可以在文档中输出上面提到作为标记的一些符号。

\*文本1\*

 

十二、扩展功能

很多编辑器还支持一些便捷的语法。

（1）目录

可以使用[TOC]命令自动生成文档的目录，当然你也可以自己用列表+链接去实现。

 

 

（2）脚注

使用中括号 + ' ^ ' +变量名来标识，鼠标悬浮可以查看定义的脚注。

这是一句话[^1]。

[^1]: 这是脚注。

 

 

（3）换行

有些编辑器需要使用2个空格 + 回车来进行标识，正常的换行不会进行换行。