markdown 让你快速无痛学会编写IT文档

Markdown就是一种文档的格式，专业名称为轻量型标记语言，主要用于编写文档类的内容，特别适合IT类的文档编写。

目前绝大多数的IT技术论坛都是支持使用markdown编写博客与文章的，例如github，简书,csdn等，在IT行业有着不可替代的作用，以其快捷简单著称~！

markdown的编写并不复杂，下面就为大家讲解markdown的10大标准编写格式吧~

编辑器此处使用的VSCODE 原生支持markdown编写，后缀为.md，另外没有编辑器，可以使用在线的编辑器呀，这里给大家推荐一个https://tool.lu/markdown/

写在最前面：所有标记和内容在一行的，标记和内容中间必须至少有一个空格，否则会被当做内容处理！

1.标题的编写

标题主要分为两大类：主副标题和多级标题

主副标题：

主标题：内容的下一行使用连续三个===
副标题：内容的下一行使用连续三个—

南风老师为何光屁股直播？（主标题）
===

震惊，南风老师没裤衩换了！（副标题）
---


此处省略1W字，简单的说，南风老师的裤衩不是脏了没洗就是洗了没干~！

显示效果：

多级标题:相当于H1-H6标签

标题内容前面使用# ，几个#就是多少级标题，最多6个~

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

显示效果为：

注意:使用多级标题，#后面必须有空格

---

2. 列表的编写

列表分为两大类：有序列表 和无序列表

有序列表

有序列表需要使用数字进行编号。

AMD6000系列显卡性能排行：

1. RX6900XT
2. RX6800XT
3. RX6800
4. RX6700XT
5. RX6600XT
6. RX6600
7. RX6500XT

显示效果为：

无序列表

无序列表使用的符号 - + * 任意一个都可以

AMD显卡厂商:

+ 华硕
+ 微星
+ 讯景
+ 瀚恺
+ 蓝宝石


AMD显卡厂商:(喜欢)

- 华硕
- 微星
- 讯景
- 瀚恺
- 蓝宝石


AMD显卡厂商:

* 华硕
* 微星
* 讯景
* 瀚恺
* 蓝宝石

显示效果为：

列表也可以嵌套使用

英伟达显卡厂商及产品分类

- 华硕
  1. 玩家国度
  2. 骑士系列
  3. Mini系列 
- 微星
  1. 闪电
  2. 超龙
  3. 魔龙
  4. 万图师 
- 七彩虹
  1. 九段
  2. 烈焰战神X-TOP
  3. 烈焰战神-U
  4. 冰封骑士

显示效果为：

注意：列表的嵌套使用无所谓有序与无序都可以互相嵌套

---

3. 表格

表格书写包含行列设计以及对齐方式。

表格格式

|姓名|性别|年龄|三维|
|---|:---|---:|:---:|
|南风|男|99|99,99,99|
|楚楚|女|18|6D,85,115|
|玉米|男|14|38D,120,110|

显示效果:

提示：在源代码中，|—|—|—|格式用于控制列数，|—:|中的冒号用于控制内容的对其方式，

|:---| 表示该列内容靠左对齐，
|---:| 表示该列内容靠右对齐
|:---:| 表示该列内容剧中对齐
注意：，第一行内容为表格的表头设置，必须填写，且表头默认居中对齐不受对齐方式的影响,另外内容两侧可以随意添加空格和缩进，没有影响，不过没有必要，源代码不需要上线对齐。

---

4.分割线

分割线就一种样式 但是有6种格式：
都是在新的一行开头连书！！

分割线1 -> ***

***

分割线2 -> * * *

* * * 

分割线3 -> ---

---

分割线4 -> - - -

- - - 

分割线5 -> ___

___

分割线6 -> _ _ _ 

_ _ _ 

显示效果为：

注意：分割线的符号需要与内容隔开一行，否则部分编辑器解析有问题，分割线的符号最少三个 多了不限制

---

5.字体

字体样式一共四种：斜体 粗体 粗斜体 删除线

斜体

内容两侧使用一个星号*或者一个下划线_

*一个人站不住*

_一个人站不住_

显示效果为：

粗体

内容两侧使用两个星号*或者两个下划线_

**两个人开起来粗**

__两个人开起来粗__

显示效果为：

斜粗体

内容两侧使用三个星号*或者三个下划线_

***三个人又斜又粗***

___三个人又斜又粗___

显示效果为：

删除线

内容两侧使用两个波浪线~~

南风老师你来看，这个花裤衩不要~~998~~，不要~~98~~，只要9.8，高高兴兴穿回家！在不买就没啦！

显示效果为：

markdown中并不能改变字体的大小和颜色，因为那不是标准功能 ，当然如果你学过HTML大可直接用HTML源代码编写，markdown可以识别，例如：

<span style="color:yellow">花裤衩子</span>

显示效果：

---

6. 超链接

超链接分为: 内容超链接和直连超链接

内容超链接

简单的说就是显示给用户看的内容文字可以自己设定。

[点击去度娘](http://www.baidu.com)

显示效果：

点击去度娘

鼠标点击文字就可以打开百度页面。

直连超链接

直接超链接无法定义内容直接将链接地址暴露给用户。

<http://www.baidu.com>

显示效果：

http://www.baidu.com
鼠标点击文字就可以打开百度页面。

7.图片

图片分为2类：网络图片，本地图片

网络图片

![alt内容](https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png "度娘")

显示效果：

不要在意颜色。。。该图片为png透明图片，颜色是编辑器的背景色。

本地图片

![alt内容](./imgs/baidu.png "title内容")

显示效果：

与网络图片并无不同，不过需要注意的是该图片必须存在与你的电脑的指定路径中

./imgs/baidu.png 表示图片在当前文件夹下面的imgs文件夹中，名称为baidu.png

![alt内容](图片地址  "title内容")			这是图片的标准格式，下面给大家说明每个区域的作用

alt内容：图片失效的时候显示的文字 可以省略
图片地址：图片的网址或者位置
title内容:鼠标放在图片上的显示文字 可以省略

---

8.代码块

代码块分为2类：单行代码块和多行代码块

单行代码块

`const user = 'southwind!';`

显示效果：

颜色由编辑器决定！课程编辑器为VScode，黑色主题

多行代码块

多行代码块还有具体的划分，分为通用代码块与特定语言代码块

通用代码块格式

在代码的前一行和最后另起一行，使用连续的三个反引号 ` ,反引号为键盘数字1前面的~按键，按住shift

定义一个js函数

```
function user(sex){
    return sex;
}
```

显示效果

代码块区域会被加上特定的背景颜色，颜色由编辑器决定！
注意：如果你需要在代码块中使用markdown的代码块内容，可以在最外层多写几个反引号就行啦！一般不会遇到，除非你是老师，哈哈哈哈

特定语言代码块

如果你知道代码区域是什么语言编写的话，可以进行语种标记，例如

定义一个js函数

```javascript
function user(sex){
    return sex;
}
```

显示效果为：

定义一个python函数

```python
def  user(sex)
	return sex
```

显示效果为：

---

9.内容引用

内容引用指引用其他人的话或者文章，需要进行标注。
在需要引用的内容行最开头添加一个> 即可，>后面必须有空格

许褚：
> 谁来与我大战三百回合!~

显示效果：

引用也可以多行内容

许褚：
> 谁来与我大战三百回合!~
> 谁来与我大战三百回合!~
> 谁来与我大战三百回合!~
> 谁来与我大战三百回合!~

或者

许褚：
> 谁来与我大战三百回合!~
谁来与我大战三百回合!~
谁来与我大战三百回合!~
谁来与我大战三百回合!~

显示效果为：

如果后面内容想脱离引用也很简单，单独空出一行就好啦~！

诸葛亮:
> 观今夜天象，
知天下大事！

大哥再见！ 空一行就可以脱离引用

显示效果

引用也可以嵌套使用

刘备:
> 我们三弟知识渊博，博古通今，经常说：
> > 俺也一样！

显示效果

---

10.锚点

锚点是作为文章中快速定位使用的格式，可以配合链接实现点击链接跳转到页面的指定位置

锚点并不需要用户特意处理，因为页面中每个标题你都会自动成为锚点，只需要设置对应的链接即可！

当前页面有很多标题了！~ 无论是1.2.3.4这样的大标题还是标题中的小标题都可以直接使用。
格式为:

[显示内容](#标题名称)

显示结果就是一个链接

这样我们就可以制作返回顶部，返回底部之类的链接啦~~~

对啦，注意看优快云右侧的目录哟，那里会自动生成当前文章的锚点哟，因为该文章使用markdown编写！

恭喜，到此为止我们的标准化markdown的规范就介绍完成啦，当然编辑器可能会添加的扩展功能和格式不在此处的讨论之列哟！！！