Markdown 基础语法汇总

大家一开始以为，文档处理不过就是写写字，然后 txt（文本）诞生了。

后来文秘们发现，文档并不只是文字，还要各种排版，然后增强版的 rtf（富文本）诞生了。

再后来文秘们发现，文档并不只是排版，还包括页眉页脚，数学公式等排版，然后威力增强版的 doc（文档）诞生了。

再后来网络开发人员发现，上面的文档在网页上直接呈现在网络传输中太笨重了，大家并不需要这么丰富的排版功能，然后精简版的 html（超文本标记语言）诞生了。

再后来开发人员发现，其实我在写开发文档的时候，只是想简单写个纪要，只需要最简单的几个标识而已，html 还是太笨重了，然后 markdown（轻量级标记语言）诞生了。

上面各种格式都一直共存，大家只是通过实践发现，原来我们的编辑需求可以细分这么多的场景。

前言

Markdown 是一种轻量级标记语言， 它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 XHTML（或者 HTML）文档。

由于 Markdown 的轻量化、易读易写特性，并且对于图片，图表、数学式都有支持，许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。

快捷键

功能	快捷键
加粗	Ctrl + B
斜体	Ctrl + I

基本语法

字体设置斜体、粗体、删除线

输入内容：

*倾斜*
_倾斜_
**加粗**
~~删除线~~
***倾斜加粗***

显示效果如下：
倾斜
倾斜
加粗
删除线
倾斜加粗

分级标题

写法 1:

# 一级标题
## 二级标题
### 三级标题

写法 2：

一级标题
===
二级标题
---

链接

插入本地/互联网上的图片

格式如下：

![图片描述](图片路径)

例如：

![Markdown](https://img0.baidu.com/it/u=2858396836,3387897168&fm=253&fmt=auto&app=138&f=JPEG?w=500&h=250)

显示为： 注意：图片描述可以不写。

插入网页链接

格式如下：

[网页描述](网页链接)

例如：

[old-driver-zeroの小屋](https://old-driver-zero.github.io)

显示为： old-driver-zero の小屋

自动连接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用<>包起来， Markdown 就会自动把它转成链接。也可以直接写，也是可以显示成链接形式的。

例如：

<https://old-driver-zero.github.io/>

显示： https://old-driver-zero.github.io/

分割线

你可以在一行中用三个以上的星号*、减号-、底线_来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。

---
***
___

显示：

---

---

---

代码块

对于程序员来说这个功能是必不可少的，插入程序代码的方式有两种，一种是利用缩进Tab, 另一种是利用英文``符号（一般在 Esc 键下方，和~同一个键）包裹代码。

行内式

如果在一个行内需要引用代码，只要用反引号```引起来就好，如：

学习`printf`函数

显示为： 学习printf函数

多行代码块与语法高亮

在需要高亮的代码块的前一行及后一行使用三个单反引号`包裹，就可以了。

例如：

```C
#include<stdio.h>
int main(){
printf("Hello, World\n");
return 0;
}
```

显示为：

#include<stdio.h>
int main(){
printf("Hello, World\n");
return 0;
}

代码块里面包含 html 代码

在代码区块里面， & 、 < 和 > 会自动转成 HTML 实体，这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码，只需要复制贴上，剩下的 Markdown 都会帮你处理。
示例如下：

<table>
  <tr>
    <th>功能</th>
    <th>快捷键</th>
  </tr>
  <tr>
    <td>加粗</td>
    <td>Ctrl + B</td>
  </tr>
  <tr>
    <td>斜体</td>
    <td>Ctrl + I</td>
  </tr>
</table>

显示：

功能	快捷键
加粗	Ctrl + B
斜体	Ctrl + I

引用

使用示范：

> 一级引用
>> 二级引用

输出如下：

一级引用

二级引用

列表

无序列表

使用 *，+，- 表示无序列表。
注意：符号后面一定要有一个空格，起到缩进的作用。

如：

- 一级列表
 - 二级列表

输出：

• 列表文字
  • 二级列表

有序列表

使用数字和一个英文句点表示有序列表。
注意：英文句点后面一定要有一个空格，起到缩进的作用。

点后面不加空格就是正常显示：
1.有序列表
2.有序列表

这才是有序列表：
1. 有序列表
2. 有序列表
 1. 二级列表
 2. 二级列表

点后面不加空格就是正常显示：
1.有序列表
2.有序列表

这才是有序列表：

1. 有序列表
2. 有序列表
   1. 二级列表
   2. 二级列表

注意：在使用列表时，只要是数字后面加上英文的点，就会无意间产生列表，比如 2017.12.30 这时候想表达的是日期，有些软件把它被误认为是列表。解决方式：在每个点前面加上\就可以了。如下图所示：

2022\.11\.1

显示为： 2022.11.1

表格

表格的基本写法很简单，就跟表格的形状很相似。 表格对齐方式：我们可以指定表格单元格的对齐方式，冒号:在左边表示左对齐，右边表示有对齐，两边都有表示居中。

| 学号 | 姓名 | 分数 |
| :--- | :--: | ---: |
| 小明 |  男  |   75 |
| 小红 |  女  |   79 |
| 小陆 |  男  |   92 |

效果：

学号	姓名	分数
小明	男	75
小红	女	79
小陆	男	92

表格中想要使用 | 可利用 <code>&#124;</code>（代码中的）或 |（直接输出）代替

常用技巧

换行

方法 1：连续两个以上空格+回车

方法 2：使用 html 语言换行标签

缩进字符

不断行的空白格或半角的空格或全角的空格或

未缩进之前的对照
 缩进1/4中文
 缩进1/2中文，1字符
 缩进1中文，2字符

未缩进之前的对照
 缩进 1/4 中文
 缩进 1/2 中文，1 字符
 缩进 1 中文，2 字符

特殊符号

Markdown 中的语法符号

对于 Markdown 中的语法符号，前面加反斜线\即可显示符号本身。

\\ 反斜线
\* 星号
\_ 下划线
\{\} \[\] \(\) 括号
\# 井号
\+ 加号
\- 减号
\. 句点
\! 惊叹号

\ 反斜线
* 星号
_ 下划线
{} [] () 括号
# 井号
+ 加号
- 减号
. 句点
! 惊叹号

其他特殊字符

❤
★
☎

❤ ★ ☎

想知道字符对应的 Unicode 码，可以看这个网站：https://unicode-table.com/cn/

字体、字号与颜色

Markdown 是一种可以使用普通文本编辑器编写的标记语言，通过类似 HTML 的标记语法，它可以使普通文本内容具有一定的格式。但是它本身是不支持修改字体、字号与颜色等功能的！
接下来要讲的功能就需要使用内嵌 HTML 的方法来实现。
字体，字号和颜色编辑如下代码：

<font color=#0099ff size=7 face="黑体">color=#0099ff size=7 face="黑体"</font>
Size：规定文本的尺寸大小。可能的值：从1到7的数字。浏览器默认值是3

color=#0099ff size=7 face="黑体"

颜色名列表参见：颜色名称及色样表（HTML）版)

链接的高级操作

行内式

这个在上文第二条基本语法的链接这个小节已经过，这里就不继续讲解了。

参考式链接

在文档要插入图片的地方写![图片或网址链接][标记]，在文档的最后写上[标记]:图片地址 “标题”。（最后这个”标题”可以不填写） 示例如下：

[Markdown 百度百科][1]

[1]: https://baike.baidu.com/item/markdown/3245829?fr=kg_general "Markdown 百度百科"

Markdown 百度百科

内容目录

在段落中填写 [TOC] 以显示全文内容的目录结构。

锚点

锚点其实就是页内超链接。比如我这里写下一个锚点，点击回到目录，就能跳转到目录。 在目录中点击这一节，就能跳过来。

语法说明：

在你准备跳转到的指定标题后插入锚点，然后在文档的其它地方写上连接到锚点的链接。

hexo markdown 文章里面如果使用 ## 文章二级标题 生成标题，标题会自动生成 id="文章二级标题"。 如果标题中间有 半角空格 或者 全角空格 ，空格都会变成连字符。

如：一个半角空格 ## hello world 或 多个半角 ## hello world 或 多个全角空格 ## hello world 。

其生成的 id 会变成 id="hello-world"，多个空格会合并成一个连字符。

说完了生成的锚点 id ，再说说如何添加跳转到锚点。

使用 markdown 内置的链接方式即可，其中如果有空格，需要把空格换成连字符 - ，如下：

跳转到博客[正则表达式](./2f57a694#元字符)

跳转到博客正则表达式

注意： 这儿优先使用文章 Front-matter 中的permalink字段，如果没有 permalink ，则使用 文件名字！

注意：

1. 如果文章中有图片，可能会出现锚点位置不准确问题，原因是图片加载成功之后会把内容高度撑开。

2. 如果如果有空格，需要把空格换成连字符 -。

注脚

语法说明： 在需要添加注脚的文字后加上脚注名字[^注脚名字],称为加注。然后在文本的任意位置(一般在最后)添加脚注，脚注前必须有对应的脚注名字。

示例如下：

使用Markdown[^1]可以高效地书写文档，直接转换成HTML[^2]。

[^1]: Markdown是一种纯文本标记语言
[^2]: HyperText Markup Language 超文本标记语言

结果显示：

使用 Markdown[^1]可以高效地书写文档，直接转换成 HTML[^2]。

[^1]: Markdown 是一种纯文本标记语言 [^2]: HyperText Markup Language 超文本标记语言

注：脚注自动被搬运到最后面，请到文章末尾查看，并且脚注后方的链接可以直接跳转回到加注的地方。

背景色

Markdown 本身不支持背景色设置，需要采用内置 html 的方式实现：借助 table, tr, td 等表格标签的 bgcolor 属性来实现背景色的功能。

举例如下：

<table><tr><td bgcolor=orange>背景色是：orange</td></tr></table>

效果如下：

背景色是：orange

制作一份待办事宜—-Todo 列表

- [ ] 未处理的事情
- [x] 已处理的事情

• [ ] 未处理的事情
• [x] 已处理的事情