Markdown 速查手册

参考

• Markdown 官方教程
• Markdown 语法对应的 HTML 标签实现

标题

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
......

文本

基本类型

*斜体文本*
或 _斜体文本_
**粗体文本**
或  __粗体文本__
***粗斜体文本***
或 ___粗斜体文本___
~~删除线~~
<u>带下划线的文本</u>

斜体文本
或 斜体文本
粗体文本
或 粗体文本
粗斜体文本
或 粗斜体文本
删除线
带下划线的文本

引用文本

> 引用文本
> >嵌套引用文本
> > >套中套。。。

引用文本

嵌套引用文本

套中套。。。

高亮文本

使用一对反引号能使行内部分文字高亮

`html` `css` `javascript`

html css javascript

代码区块

用三个反引号 ``` 包裹一段代码，并指定一种语言（也可以不指定），指定代码语言后会有代码的颜色高亮

本代码区块为示例说明：

​```javascript
function test() {
	alert('test')
}
​```

效果：

function test() {
	alert('test')
}

角标(HTML)

H<sub>2</sub>O  CO<sub>2</sub>
2<sup>10</sup> 10<sup>2</sup>

H₂O CO₂
2¹⁰ 10²

脚注

脚注是对文本的补充说明。

需要添加脚注的文本[^脚注]

//用于解释说明脚注，自动添加在页脚
[^脚注]: 注明框内显示的内容

需要添加脚注的文本^脚注

链接

可使用相对路径（前提是有该路径下的文件）

基本链接

• [链接名称](链接网址)
• [链接名称](链接网址 "文字说明")
• <链接网址>

文字说明通过鼠标悬浮链接上查看

[百度](https://www.baidu.com/)
[百度](https://www.baidu.com/ "百度搜索")
<https://www.baidu.com/>

百度
百度
https://www.baidu.com/

锚点链接

每一个标题都是一个锚点，和HTML的锚点（#）类似

[Markdown](#Markdown)

注： Github对含有标点符号的标题进行锚点时会忽略掉标点符号
如果这样写则无法跳转：[链接](#九、链接)
正确写法：[链接](#九链接)

图片

和链接的区别是前面多一个感叹号!

![图片名](图片链接)

徽章

徽章是一种小巧精美的图标，一般配有相关文字进行辅助说明，可对数据进行监控，链接跳转等，富有表现力。

常见于github项目主页，但其不仅出现于 github 项目主页，凡是能够表现图片的地方都可以出现徽章。

格式:
[![图片文字说明](图片源地址)](超链接地址)  # 即超链接内部嵌套图片

语法：
[![github](https://img.shields.io/badge/github-pbloods-brightgreen)](https://github.com/pbloods)

徽章生成网站：https://shields.io/

如想设置图片宽高，可以使用 <img> 标签。

<img src="https://pblood.oss-cn-hongkong.aliyuncs.com/img/site/logo.png" width="50px" height="50px">

列表

无序列表

*、+或者-加空格

- 第一项
- 第二项
- 第三项

有序列表

数字.+空格

1. 第一项
2. 第二项
3. 第三项

带复选框列表

* [x] 第一项
* [ ] 第二项
* [ ] 第三项

• 第一项
• 第二项
• 第三项

嵌套列表

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

1. 第一项：
   • 第一项嵌套的第一个元素
   • 第一项嵌套的第二个元素
2. 第二项：
   • 第二项嵌套的第一个元素
     • 第三层嵌套

表格

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

|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

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

对齐方式：

• -: 设置内容和标题栏居右对齐
• :- 设置内容和标题栏居左对齐
• :-: 设置内容和标题栏居中对齐

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

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

段落

在需要段落缩进的文本前面使用2个Tab，类似代码块效果，里面不支持Markdown语法，不好使

换行

直接回车即可

分隔线

在Markdown 分隔线需要使用* 或-或_来建立

都需要三个及其以上，可以在中间插入空格，但不能在行内存在其他内容，当前后都有段落时，请空出一行

* * *
- - - 
_ _ _

***

---

---

---

---

目录

在需要目录出现的地方（一般在文章一开始）放置一个[toc]标记，会自动生成一个嵌套的包含所有标题的列表。

代码示例：

[toc]

注释

在Markdown中，注释可以自定义

• 可以使用html语法注释
• 可以使用*[·-·]:注释内容格式进行注释，其中[]中的内容可以自定义

这些注释在代码段中无效，代码块中注释是根据所指定语言进行注释

<!--注释，不会显示-->
[comment]: <> (注释，不会显示)
[//]: <> (注释，不会显示)
[//]: # (注释，不会显示)
*[^_^]:注释，不会显示
*[@_@]:注释，不会显示

支持的 HTML 元素

不在 Markdown 语法涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。

目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>等等 ，如：

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

使用 Ctrl+Alt+Del 重启电脑

我是使用b标签的加粗字体

一组Markdown中混用HTML案例

位置(HTML)

<div align=left> 左对齐 </div>
<div align=right> 右对齐 </div>
<div align=center> 居中 /<div>
<center> 居中 </center>

左对齐

右对齐

居中

居中

折叠(HTML)

<details>
<summary>点我打开关闭折叠</summary>
 折叠内容
 <ul>
	 <li>1</li>
	 <li>2</li>
	 <li>3</li>
 </ul>
</details>

注意：<details> 标签内写markdown代码无效，可写html代码，如ul>li、table等

点我打开关闭折叠

折叠内容

• 1
• 2
• 3

包含table的折叠

分类	例词
人称代词-主格	I我，you你，he他，she她，they他们， we我们
人称代词-宾格	me我， you你， him他， her她， them他们， us我们
物主代词	my我的， his他的， your你的（your你们的）， their他们的， hers她的
指示代词	this这， that那， these这些， those 那些
反身代词	myself我自己， himself他自己， themselves他们自己， yourself你(们)自己，herself她自己
疑问代词	who谁， what什么， which哪个
不定代词	some一些， many许多， both两个、两个都， any许多
关系代词	which……的物， who……的人， that……的人或物， who谁， that引导定语从句
相互代词	each other 互相， one another互相
连接代词	who,whom,whose,what,which,whatever,whichever,whoever,whomever
替代词	one（单数），ones（复数）

转义

Markdown 使用了很多特殊符号来表示特定的意义，如果需要显示特定的符号则需要使用反斜杠转义字符：

**未转义星号显示加粗**
\*\* 转义显示星号 \*\*

未转义星号显示加粗
** 转义显示星号 **