MarkDown语法

什么是markdown

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

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

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

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

初步使用MarkDown

准备

下载markdown编辑器Typora并激活使用
Typora官网（收费）：https://typoraio.cn/

Typora破解方法：见参考1
Typora自带很多快捷操作，可以点击鼠标右键进行查看

---

基本语法

标题

Markdown 标题有两种格式：
一是使用 # 标记
使用#号可表示1-6 级标题，一级标题对应一个 # 号，二级标题对应两个 # 号，以此类推。

---

• 一级标题

• 二级标题

• 三级标题

• 四级标题

• 五级标题

• 六级标题

---

二是加 == 表示 一 级标题或者--表示二级标题

一级标题

二级标题

注意：#后面至少有一个空格

段落格式

用空白行将一行或多行文本进行分隔

第一行文本
 
第二行文本
第三行文本  （两个空格+回车）
第四行文本

段落的换行是使用两个以上空格加上回车。

字体

斜体 在需要斜体的文本前后各添加一个 * 或 _

*斜体*

斜体
粗体 在需要加粗的文本前后各添加两个 ** 或者下划线 __ ，建议用 **

**粗体**

粗体
粗斜体 在需要粗斜体的文本前后各加三个 *** 或 ___

***粗斜体***

粗斜体

围栏区块

在代码块之前和之后的行上使用三个反引号（(```）或三个波浪号（~~~）。

注意对应

许多Markdown处理器都支持受围栏代码块的语法突出显示。使用此功能，您可以为编写代码的任何语言添加颜色突出显示。要添加语法突出显示，请在受防护的代码块之前的反引号旁边指定一种语言。
如

python代码块

java代码块等

代码

要将单词或短语表示为代码，请将其包裹在反引号 (`) 中。

如果你要表示为代码的单词或短语中包含一个或多个反引号，则可以通过将单词或短语包裹在双反引号(``)中。

use `code` in my markdown file
要创建代码块，请将代码块的每一行缩进至少四个空格或一个制表符。

链接

链接文本放在中括号内，链接地址放在后面的括号中，链接title可选。

这是一个超链接

引用

在段落前添加一个>
块引用可以有多个段落，在段落间的空白行加一个>

Make it happen now, not tomorrow. Tomorrow is a loser's excuse.
— Farrah Gray

块引用可以进行嵌套处理
也可以带有其他markdown格式的元素，但不是所有都可以

图片

要添加图像，请使用感叹号 (!), 然后在方括号增加替代文本，图片链接放在圆括号里，括号里的链接后可以增加一个可选的图片标题文本。

表格

使用三个或多个连字符（---）创建每列的标题，并使用管道（|）分隔每列。您可以选择在表的任一端添加管道

表头	表头
单元格	单元格
单元格	单元格

单元格宽度可以变化

对齐
可以通过在标题行中的连字符的左侧，右侧或两侧添加冒号（:），将列中的文本对齐到左侧，右侧或中心。

表头	表头	表头
左侧	右侧	居中
单元格	单元格	单元格

可以添加链接，代码（仅反引号（`）中的单词或短语，而不是代码块）和强调。
不能对表格中的文章添加标题，块引用，列表，水平规则，图像或HTML标签。

列表语法

要创建有序列表，请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列，但是列表应当以数字 1 起始。注意 空格

1. 创建列表1
2. 创建列表2

要创建无序列表，请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。注意 空格

• 无序列表1
• 无序列表2

也可以嵌套其他markdown元素
要在保留列表连续性的同时在列表中添加另一种元素，请将该元素缩进四个空格或一个制表符

• 第一种元素

  • 第二种种元素

    • 第三种

分隔线

在单独一行上使用三个或多个星号 (***)、破折号 (---) 或下划线 (___) ，并且不能包含其他内容。

使用*创建分隔线

---

使用-创建分隔线

---

使用_创建分隔线

---

参考

[1] https://www.cnblogs.com/xiaohi/p/15907083.html
[2] https://www.runoob.com/markdown/md-tutorial.html