江上一小白

2022-03-28 21:08 掌控网络（外勤365）_SFA_软件工程师

关注

如何写好MarkDown

文章目录

MarkDown

MarkDown

参考文献：MarkDown语法

MarkDown作为一个便捷又高效通用的文档编写工具，易读易写，同时可以导出为Word、PDF、HTML，本身的.md格式文件，很多博客网站、GitHub、简书等都是可以通用的。

语法主要以标记符号为主，在日常文档编写中十分便捷，下面推荐一些常用的语法和标记符号，提高排版，更加优雅的记录。

1. 标题

创建标题，可以通过添加井号来实现（#）。#的数量可以来标记标题的级别，通常数量越多，级别越低，# 与标题文字之间需要空格分开。

第一种（使用一组 # ，最多标题到六级）

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
####### 七级标题

第二种（使用一对 # ，最多标题到六级）
```
# 一级标题 #
## 二级标题 ##
```
第三种（使用“=”表示一级，“-”表示二级）
```
这是一级标题
======
这是二级标题
--------
```

2. 列表

列表分为有序列表和无序列表，一级实心圆，二级空心圆

无序列表

使用 * ， +， - 来创建，转为html文件的时候为ul > li

### 无序列表
* 1
	* 1.1
	* 1.2
* 2
* 3
+ 1
+ 2
+ 3
- 1
- 2
- 3

1
- 1.1
- 1.2
2
3

有序列表

以第一个为开始递增，使用阿拉伯数字 + 英文" . " + 空格

### 有序列表
3. 列表1
2. 列表2
1. 列表3

列表1
列表2
列表3

3. 区块引用

对某个或某块语句做特殊表示，通过使用 " > " + 空格

创建区块引用
```
> 这是一个区块引用
```
这是一个区块引用
创建多个段落的区块引用
```
> 这是第一段区块引用
> 这是第二段区块引用
> 
> 这是第三段区块引用
```
这是第一段区块引用
这是第二段区块引用

这是第三段区块引用

嵌套与混合使用区块引用

> 失败乃成功之母
	> 我不知道是谁说的
> 成功乃成功之父
	> 我不知道有没有人说过，反正我说过
	
> ## 标题
> * 前方高能
>	> 高能
> * 前方低能
> 	> 低能

失败乃成功之母

我不知道是谁说的
成功乃成功之父

我不知道有没有人说过，反正我说过

标题

前方高能

高能

前方低能

低能

4.分割线

分割线由 * - _(星号，减号，底线)三个符号的至少3个表示，不用连续

***

---

___

5.链接

超链接语法：[超链接显示名称](超链接地址 "超链接title")

链接

这是百度[链接](http://www.baidu.com)

这是百度链接

链接加title

[name](http://www.baidu.com "名称")
[home](http://www.baidu.com "首页")
[支持中文](/home/name "加油")

name
home
支持中文

网址和Email地址
```
<https://www.baidu.com>
<mail@email.com>
```
https://www.baidu.com
mail@email.com

6.图片

图片语法：![图片alt](图片链接 "图片标题")

图片

![我是图片](https://img-blog.csdnimg.cn/20210408174016270.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzNDI5OTE5,size_16,color_FFFFFF,t_70  "我是图片")

图片链接

[![我是图片](https://img-blog.csdnimg.cn/20210408174016270.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzNDI5OTE5,size_16,color_FFFFFF,t_70  "我是图片")](https://www.baidu.com)

7.代码框

单行：单反引号包起来
```
`<p><a href="/home" title="说明"></a></p>`
```
<p><a href="/home" title="说明"></a></p>

多行：3个`

```注释
<p><a href="/home" title="说明"></a></p>
<p><a href="/home" title="说明"></a></p>
<p><a href="/home" title="说明"></a></p>

<p><a href="/home" title="说明"></a></p>
<p><a href="/home" title="说明"></a></p>
<p><a href="/home" title="说明"></a></p>

8.表格

| name | age | sex |
|:-----:|:-----:|
| tony | 20 | 男 |
| Lucy | 18 | 女 |

表头1 | 表头2
--------|-------
Content cell | content cell 
Content cell | content cell 

学号|姓名|分数
-|-|-
001|小红|95
002|小黑|86
003|小白|105

示例：

name	age	sex
tony	20	男
Lucy	18	女

表头1	表头2
Content cell	content cell
Content cell	content cell

学号	姓名	分数
001	小红	95
002	小黑	86
003	小白	105

9.强调

粗体

两个星号（*）或者是两个下划线（_）包起来
```
**字体加粗**
__字体加粗__
```
字体加粗
字体加粗
斜体

一个星号（*）或者是一个下划线（_）包起来
```
*字体倾斜*
_字体倾斜_
```
字体倾斜
字体倾斜
粗体加斜体

三个星号（*）或者是三个下划线（_）包起来
```
***粗体和斜体***
___粗体和斜体___
```
粗体和斜体
粗体和斜体