markdown语法介绍

markdown语法介绍

       markdown是一种为了易于编写阅读的语言，他语法简单，可以转换为pdf、html、word等文档格式。下面就简单介绍下markdown的语法。

标题语法介绍

       与html相同，markdown的标题也分为标题1到标题6，分别对应多个#号，标题1为一个#号接一个空格。标题2为两个#号接空格。后面的标题以此类推。

# h1
## h2
### h3
#### h4
##### h5
###### h6

上述代码的效果：

h1

h2

h3

h4

h5

h6

同时我们也可以用第二行为-或者=符号来表示标题1与标题2

h1
===
h2
---

效果如下：

h1

h2

分割线

       markdown中由三种形式的下划线，用*、-或者_三个符号中的任意一个重复三次以上，都可以表示为分割线。代码如下：

***
___
---

效果如下：

---

---

---

符号与字体

换行/段落符

       在markdown中，我们用单行结尾两个空格代表段落分隔符

这是一个段落结尾  

效果如下：

这是一个段落结尾
这是段落开始

字体

       通常，在markdown中，表示分割符的*、_包裹相关内容就代表斜体，两个符号包裹相关内容代表粗体，三个符号包裹内容代表斜粗体。示例如下：

_斜体_
*斜体*
**粗体**
__粗体__
***粗斜体***
___粗斜体___

展示效果如下：

斜体
斜体
粗体
粗体
粗斜体
粗斜体

在html中。我们用<del>del</del>可以表示删除线，也可以用<u>underline</u>，同时在markdown语法中，我们也可以使用开始与结束都是用两个~符号来表示删除线：

<del>del</del>
~~~del~~~
<u>underline</u>

展示效果如下：

del
del
underline

列表

无序列表

markdown中无序列表用+,-,*加空格再加内容则表示无序列表：

+ list
+ list1
+ list2

* list
* list1
* list2

- list
- list1
- list2

展示效果如下：

• list
• list1
• list2

• list
• list1
• list2

• list
• list1
• list2

有序列表

markdown中的有序列表通常用数字+.表示：

1. list1
2. list2
3. list3
4. list4

展示效果：

1. list1
2. list2
3. list3
4. list4

需要注意的是，markdown中的有序列表会自动排序，例如如下代码：

1. list1
1. list2
1. list3  
1. list4

展示效果为：

1. list1
2. list2
3. list3
4. list4

亦或者是如下代码：

5. list1
4. list2
3. list3

展示效果为：

5. list1
6. list2
7. list3

有序列表都会从第一个列表位置开始重新排序

列表嵌套

如果列表需要嵌套，在上一列表的后面一个列表，连续输入三个以上空格，根据要求添加有序或者无序列表即可，如：

* list1
  * list1.1
* list2
  1. list1
  2. list2
* list3
* list4

1. list1
2. list2
3. list3
   1. list3.1
   2. list3.2

效果如下：

• list1
  • list1.1
• list2
  1. list1
  2. list2
• list3
• list4

1. list1
2. list2
3. list3
   1. list3.1
   2. list3.2

列表注意事项

由于有序列表会自动重排序列，在markdown中我们通常不建议做列表嵌套。这可能会增加一些不必要的麻烦。

代码

在markdown中，代码的表示分为代码块与代码分段。

代码片段

markdown中用`符号中间包裹的内容即为代码片段：

`System.out.println("Hello world!");`

Java “hello world”代码：System.out.println("Hello world!");。

如果是用三个`或者~包裹的内容，则代码代码块。如：

```
code1
```

或者：

~~~
code2
~~~
展示效果如下：

code1

code2

我们可以在表示代码块的第一行填写语言，就可以为指定的语言语法来更改样式，代码示例：

```javascript

```

参考下如下示例，看下指定了语法与未指定语法的区别：

1. 未指定语法

alert("a");

2. 指定语法为javascript

alert("a");

链接添加

[百度(直接指定链接)](https://www.baidu.com)

直接展示链接：<https://www.baidu.com>

[百度(这是一个指向链接，指向链接1)][1]

[1]: https://www.baidu.com

这是一个脚注[^footer]

[^footter]:脚注解释

展示结果如下：

百度(直接指定链接)

直接展示链接：https://www.baidu.com

百度(这是一个指向链接，指向链接1)

这是一个脚注[^footer]

图片

// 直接展示图片
![百度](https://www.baidu.com/img/flexible/logo/pc/result.png)
// 展示图片与图片标题
![百度](https://www.baidu.com/img/flexible/logo/pc/result.png "百度")
// 展示图片并且链接
![百度](https://www.baidu.com/img/flexible/logo/pc/result.png "百度")[1]

展示效果如下：

直接展示：

展示图片与图片标题

展示图片并且链接
1

表格

markdown中，用竖线加内容隔开，加竖线和中线分割，后面表格内容用竖线分隔：

|header1|header2|header3|
|---|---|---|
|r1c1|r2c2|r3c3

展示如下：

header1	header2	header3
r1c1	r2c2	r3c3

如果要改变默认对其方式可以用:-来改变对齐方式，默认三横线为居中对齐，冒号所在的地方为对齐的方向：

|header1|header2|header3|
|:-|:-:|-:|
|r1c1|r2c2|r3c3

header1	header2	header3
r1c1	r2c2	r3c3