引言
最近因建 网盘网站 了解了一下 Markdown,发现这玩意非常好用,于是写一份学习笔记
个人编写 Markdown 的工具为 Typora
复习可以去看官方的速查表 Markdown 语法速查表
标题
创建一个标题,仅需#
+空格
+标题文字
,一共有六级,对应 HTML 的 h1~h6
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题
一般的网页编写,一级标题是网页标题,二级开始为内容,用到四级差不多
换行
仅需在上一行末尾加上俩个以上空格后回车即可,有些编辑器可直接换行
例如以下代码
这是第一行 //这里有俩空格,后面也有→
这是第二行
效果如下
这是第一行 //这里有俩空格,后面也有→
这是第二行
斜体 & 粗体
斜体为文本前后加一个 *
,粗体为文本前后加俩 **
例如以下代码
*这是斜体*
**这是粗体**
***这是斜体加粗体***
效果如下
这是斜体
这是粗体
这是斜体加粗体
引用
创建引用区块仅需在段首添加 >
+空格
+内容
例如以下代码
> 这是一级引用
>> 这是二级引用
>>> 这是三级引用
效果如下
这是一级引用
这是二级引用
这是三级引用
列表
可以创建有序列表和无序列表
有序列表
在列表项前添加 数字
+.
+空格
+内容
即可
例如以下代码
1. 第一项
2. 第二项
3. 第三项
效果如下
- 第一项
- 第二项
- 第三项
无序列表
使用 +
,-
或 *
+空格
+ 内容
即可,但请不要混用 (为了兼容性)
子项可以使用 四个空格
或一个 TAB
然后用父项格式即可
不过为了符合 (markdownlint) 规范,一篇文章的所有无序列表尽量用一样的,比如都用 -
例如以下代码
- 第一项
- 第一项子一项
- 第一项子二项
- 第一项子二项子一项
- 第二项
- 第三项
效果如下
- 第一项
- 第一项子一项
- 第一项子二项
- 第一项子二项子一项
- 第二项
- 第三项
代码
单行
将要变为代码的内容放在 “`” 中即可,如果代码中有 “`” ,请使用 “``”
例如以下代码
`将此内容变为代码块`
``此内容中含有'`'哦~``
效果如下
将此内容变为代码块
此内容中含有'`'哦~
代码块
可以通过将每一行缩进四个空格或一个 TAB
或者上下行 “```” 包围,要使用高亮,请在上方 “```” 后写上语言类型
为了符合规范,尽量使用第二种
例如以下代码
\`\`\` C
include<stdio.h>
int main(void)
{
printf("Hello World");
}
\`\`\`
效果如下
include<stdio.h>
int main(void)
{
printf("Hello World");
}
分割线
在单独一行使用三个及以上的 *
,-
或 _
即可
为了规范,尽量使用三个星号
例如以下代码
***
效果如下
链接
简易链接
直接将链接或邮箱地址使用 <>
括起来即可
例如以下代码
<https://yexca.net>
<yexca@duck.com>
效果如下
https://yexca.net
[email protected]
自定义文字的链接
[超链接显示名](超链接地址 "超链接 title")
,其中 "超链接 title"
可以不填
例如以下代码
[yexca的博客](https://blog.yexca.net)
[yexca的博客](https://blog.yexca.net "其实是 yexca 和 Hiyoung 的博客")
效果如下
引用类型链接
例如以下代码
[blog]: https://blog.yexca.net
[contact]: <mailto:yexca@duck.com>
这是我的[个人博客][blog],有问题可以[联系我][contact]
效果如下
图片
插入图片

,其中 图片 alt
为当图片加载失败时显示的内容,图片 title
为鼠标放图片上显示的内容
注意:部分 Markdwon 编辑器不支持 图片 title
(比如本站这个主题),为了规范,请至少确保填写 图片 alt
例如以下代码

效果如下
图片包含链接
使用链接的语法,将图片放在 []
里即可
例如以下代码
[](https://www.pixiv.net/artworks/82542737)
效果如下
转义字符
如果有不想被 Markdown 格式化的字符,只需要在前方加上 \
即可
例如以下代码
我想打出*但这会被斜体*
加上转移符\*后面就不会斜体,而且可以显示
效果如下
我想打出但这会被斜体
加上转移符*后面就不会斜体,而且可以显示
内嵌 HTML
直接使用即可,以缩略标签为例
例如以下代码
<details>
<summary>
点我试试
</summary>
被发现啦
</details>
我可以用Markdown**变粗**,也可以同时用HTML<i>变斜</i>
因为该站主题不可以直接解解析 H5,所以不演示
表格
使用三个或多个 -
创建每列标题,使用 |
分割每列,使用 :
以左,右或居中对齐 (非必须)
例如以下代码
|标题|内容|备注|
|:---|:---:|---:|
|左对齐|居中|右对齐|
效果如下
标题 | 内容 | 备注 |
---|---|---|
左对齐 | 居中 | 右对齐 |
注意:不可以在表格中添加标题,引用,列表,图像或 HTML 标签等
删除线
在要删除的内容前后添加 ~~
例如以下代码
我永远喜欢 ~~战争文学博士~~ Warma
效果如下
我永远喜欢 战争文学博士 Warma
任务列表
使用 -
+空格
+[ ]
或 [x]
+空格
+内容
例如以下代码
- [ ] 这个没完成呢
- [x] 这个完成啦
效果如下
- 这个没完成呢
- 这个完成啦
使用 Emoji 表情
复制粘贴
多数情况可直接复制
Emojipedia
上的表情直接粘贴,请确保网页编码为 UTF-8
使用表情符号简码
这个需要 Markdown 应用程序支持,以冒号 :
开头和结尾
可以通过 表情符号简码列表 查询
例如以下代码
:blush:,:smiley:
效果如下
😊,😃
脚注
类似于论文参考文献的角标
例如以下代码
这里引用了维基百科[^1],这里引用了 Github[^2]。
也可以使用英文,但不能用空格或 TAB[^yexca]
[^1]: 这里可以使用文字,然后会在上方相应位置出现
[^2]: 或者使用链接 [Github](https://github.com/yexca)
[^yexca]: [个人主页](https://lit.link/yexca)
效果如下,参考的东西在文章最末尾,点击角标可以看到
这里引用了维基百科1,这里引用了 Github2。 也可以使用英文,但不能用空格或 TAB3
注意:部分编辑器不支持