Markdown教程

---

一.简介

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档。

Markdown 语言在 2004 由约翰·格鲁伯（英语：John Gruber）创建。

Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。

Markdown 编写的文档后缀为 .md, .markdown。

编辑器推荐：Typora、VScode等。

二.标题

# 标题名字（#号的个数代表标题的级数）

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
####### 最多支持六级标题

三.段落

Markdown 段落没有特殊的格式，直接编写文字就好，段落的换行是使用两个以上Space加上Enter,也可以在段落后面使用一个空行来表示重新开始一个段落。

1.字体

Markdown 可以使用以下几种字体：

*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___

2.分割线

用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

***
* * *
*****
- - -
----------

3.删除线

在文字的两端加上两个波浪线 ~~ 即可，如下所示：

~~BAIDU.COM~~

4.脚注

脚注的格式：[^注明的文本]

格式[^注明的文本]

四.列表

1.无序列表

使用星号()、加号(+)或是减号(-*)作为列表标记，格式：符号+空格

* 无序列表1
+ 无序列表2
- 无序列表3

2.有序列表

使用数字并加上 . 号来表示，格式：数字+.+空格

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

3.列表嵌套

列表嵌套只需在子列表中的选项前面添加4个Space即可：

1. 第一项：- 第一项嵌套的第一个元素- 第一项嵌套的第二个元素
2. 第二项：- 第二项嵌套的第一个元素- 第二项嵌套的第二个元素

实例如下：

1. 水果：
   • 苹果
   • 香蕉
2. 饮料：
   • 可乐
   • 雪碧

五.区块

1.基础语法

区块引用是在段落开头使用 > 符号 ，然后后面紧跟一个空格符号，

格式：>+空格

> 天上白玉京
> 十二楼五城
> 仙人抚我顶
> 结发授长生

2.区块嵌套

区块是可以嵌套的，一个 > 符号是最外层，两个 > 符号是第一层嵌套，以此类推：

> 最一层
> > 第二层嵌套
> > > 第三层嵌套

最外层

第二层嵌套

第三层嵌套

六.代码

1.代码块

代码块中的文本（包括 Markdown 语法）都会显示为原始内容。

```语言名称（也可以不指定）

2.行内代码

也可以通过反引号（``），插入行内代码：

markdown Java Python PHP MySQL C++ public static void main(string)

格式：`内容`

七.链接

1.外部链接

格式：[链接名称](链接地址)或<链接地址>

百度

菜鸟教程

https://cn.bing.com/

2.内部链接

格式：[链接名称](#跳转名称)

[跳转至简介](#一.简介)

跳转至简介

3.高级链接

如需重复使用一个链接，我们可以通过给链接设置一个变量来重复使用它。

==注意：==使用链接网址时最好直接使用地址栏复制来的地址，不要删除http或https,可能会导致无法打开网页的情况。

此处使用以下两个网站举例：

哔哩哔哩 (゜-゜)つロ 干杯~-bilibili

纪妖（原名知妖） (cbaigui.com)

此处使用BL作为b站网址变量[哔哩哔哩 (゜-゜)つロ 干杯][BL]
此处使用JY作为纪妖网址变量[纪妖（原名知妖）][JY][BL]: https://www.bilibili.com
[JY]: https://www.cbaigui.com

此处使用BL作为b站网址变量哔哩哔哩 (゜-゜)つロ 干杯
此处使用JY作为纪妖网址变量纪妖（原名知妖）

八.表格

1.基本语法

表格使用| 来分隔不同的单元格，使用 - 来分隔表头和其他行。

为了使 Markdown 更清晰，| 和 -两侧需要至少有一个空格。

姓名 | 学号
--- | ---
张三 | 01
李四 | 02

姓名	学号
张三	01
李四	02

2.对齐方式

:号在哪边就是什么对齐：

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

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

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

左对齐 | 居中对齐 | 居中对齐
:--- | :---: | ---:
单元格 | 单元格 | 单元格
单元格 | 单元格 | 单元格

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

九.图片

格式：![图片名](图片地址)或![图片名](图片地址 "别名")

• 开头一个感叹号 !
• 接着一个方括号，里面放上图片的替代文字
• 接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上选择性的 ‘title’ 属性的文字。

![图片名](图片地址)
![图片名](图片地址 "别名")

十.高级技巧

以下部分功能可能在某些渲染器无法实现。

1.公式

格式: $公式$ $$公式$$ ````math`

 $f(x) = sin(x) + 12$$$f(x) = sin(x) + 12$$```math

$f(x)=sin(x)+12$

$$f(x)=sin(x)+12$$

f(x) = sin(x) + 12

2.高亮

格式：==文字==

实例：高亮

3.下标

格式：~文字或数字~

实例：H₂O

4.上标

格式：^文字或数字^

实例：m²

5.表情🤞

• 第一种：输入:后再输入一个 英文字母，会弹出表情符号
• 第二种：输入法直接选择
• 第三种：win+句号也可以实现

6.画图

此处简单举两个栗子😜，个人觉得太麻烦了🤦‍♂️。

Mermaid 是一个用于画流程图、状态图、时序图、甘特图的库

• 饼图（Pie）

• 流程图（graph)

方向描述：TB 从上到下；BT从下到上；RL从右到左；LR从左到右

方向箭头：–>

格式：表述+(图形节点)

graphA(圆角矩形节点)C[矩形节点]D((圆形节点))E{菱形节点}F>右向旗帜状节点] 

graph LR;A-->BB-->CC-->A

• 序列图(sequence diagram)

格式：-> 直线，–>虚线，->>实线箭头，—>>虚线箭头

对象A->对象B:请求

对象B->对象A:响应

注解：Note 位置表述 参与者: 标注文字

位置表述：right of 右侧；left of 左侧；over 在当中，可以横跨多个参与者

别名： participant 别名 as 对象

sequenceDiagram Title: 观景老师->>同学:同学，你站在楼顶干嘛，快下来！同学-->>老师:老师，这学期我能及格吗？

• 甘特图（gantt）

gantt title 标题dateFormat 日期格式section 部分名任务名:参数一, 参数二, 参数三, 参数四，参数五参数一：crit（是否重要，红框框） 或者 不填
参数二：done（已完成）、active（正在进行） 或者 不填(表示为待完成状态)
参数三：取小名 或者 不填
参数四：任务开始时间
参数五：任务结束时间

跳转至顶部

参考文献：

Markdown 高级技巧 | 菜鸟教程 (runoob.com)

markdown-tutorial | 救救笔记库 (gitee.io)