Markdown 速查手册
参考
标题
1 | # 一级标题 |
文本
基本类型
1 | *斜体文本* |
斜体文本
或 斜体文本
粗体文本
或 粗体文本
粗斜体文本
或 粗斜体文本删除线
带下划线的文本
引用文本
1 | > 引用文本 |
引用文本
嵌套引用文本
套中套。。。
高亮文本
使用一对反引号能使行内部分文字高亮
1 | `html` `css` `javascript` |
html
css
javascript
代码区块
用三个反引号 ``` 包裹一段代码,并指定一种语言(也可以不指定),指定代码语言后会有代码的颜色高亮
本代码区块为示例说明:
1 | ```javascript |
效果:
1 | function test() { |
角标(HTML)
1 | H<sub>2</sub>O CO<sub>2</sub> |
H2O CO2
210 102
脚注
脚注是对文本的补充说明。
1 | 需要添加脚注的文本[^脚注] |
需要添加脚注的文本^脚注
链接
可使用相对路径(前提是有该路径下的文件)
基本链接
[链接名称](链接网址)
[链接名称](链接网址 "文字说明")
<链接网址>
文字说明通过鼠标悬浮链接上查看
1 | [百度](https://www.baidu.com/) |
锚点链接
每一个标题都是一个锚点,和HTML的锚点(#
)类似
1 | [Markdown](#Markdown) |
注: Github对含有标点符号的标题进行锚点时会忽略掉标点符号
如果这样写则无法跳转:[链接](#九、链接)
正确写法:[链接](#九链接)
图片
和链接的区别是前面多一个感叹号!
1 |  |
徽章
徽章是一种小巧精美的图标,一般配有相关文字进行辅助说明,可对数据进行监控,链接跳转等,富有表现力。
常见于github
项目主页,但其不仅出现于 github
项目主页,凡是能够表现图片的地方都可以出现徽章。
1 | 格式: |
徽章生成网站:https://shields.io/
如想设置图片宽高,可以使用
<img>
标签。
1 | <img src="https://pblood.oss-cn-hongkong.aliyuncs.com/img/site/logo.png" width="50px" height="50px"> |

列表
无序列表
*
、+
或者-
加空格
1 | - 第一项 |
有序列表
数字.
+空格
1 | 1. 第一项 |
带复选框列表
1 | * [x] 第一项 |
- 第一项
- 第二项
- 第三项
嵌套列表
1 | 1. 第一项: |
- 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
- 第二项:
- 第二项嵌套的第一个元素
- 第三层嵌套
- 第二项嵌套的第一个元素
表格
制作表格使用 |
来分隔不同的单元格,使用-
来分隔表头和其他行
1 | | 表头 | 表头 | |
表头 | 表头 |
---|---|
单元格 | 单元格 |
单元格 | 单元格 |
对齐方式:
- -: 设置内容和标题栏居右对齐
- :- 设置内容和标题栏居左对齐
- :-: 设置内容和标题栏居中对齐
1 | | 左对齐 | 右对齐 | 居中对齐 | |
左对齐 | 右对齐 | 居中对齐 |
---|---|---|
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
段落
在需要段落缩进的文本前面使用2个Tab,类似代码块效果,里面不支持Markdown语法,不好使
换行
直接回车即可
分隔线
在Markdown 分隔线需要使用*
或-
或_
来建立
都需要三个及其以上,可以在中间插入空格,但不能在行内存在其他内容,当前后都有段落时,请空出一行
1 | * * * |
目录
在需要目录出现的地方(一般在文章一开始)放置一个[toc]
标记,会自动生成一个嵌套的包含所有标题的列表。
代码示例:
1 | [toc] |
注释
在Markdown中,注释可以自定义
- 可以使用html语法注释
- 可以使用
*[·-·]:注释内容
格式进行注释,其中[]中的内容可以自定义
这些注释在代码段中无效,代码块中注释是根据所指定语言进行注释
1 |
|
支持的 HTML 元素
不在 Markdown 语法涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
目前支持的 HTML 元素有:<kbd> <b> <i> <em> <sup> <sub> <br>
等等 ,如:
1 | 使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑 |
使用 Ctrl+Alt+Del 重启电脑
我是使用b标签的加粗字体
位置(HTML)
1 | <div align=left> 左对齐 </div> |
折叠(HTML)
1 | <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 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用反斜杠转义字符:
1 | **未转义星号显示加粗** |
未转义星号显示加粗
** 转义显示星号 **