Markdown语言

简介

Markdown 是一种纯文本格式的标记语言,通过简单的标记语法使纯文本内容按一定格式排版。比如,这里写博客用的hexo就是支持Markdown语法的,这也是本文撰写的动因。更加详细的介绍请参考: Markdown 语法・简明版

一、标题

示例:

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

二、字体

加粗

将要加粗的文字左右两边分别用两个* 号包起来

斜体加粗

要倾斜和加粗的文字左右分别用三个* 包起来

删除线

要加删除线的文字左右分别用两个~~ 号包起来

三、引用

在引用的文字前加> 即可。引用也可以嵌套,如加两个>> 三个>>> 一直到n个...

示例:

1
2
3
> 这是引用的内容
>>这是引用的内容
>>>>>这也是引用的内容

四、分割线

三个或三个以上的 - 或 * 均可。

示例:

1
2
3
4
---
----
***
****

五、图片

语法:

1
2
3
4
![图片alt](图片地址 "图片title")

图片alt就是显示在图片下面的文字,相当于对图片的解释
图片title就是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加
示例:
1
2
![blockchain](https://ss0.bdstatic.com/70cFvHSh_Q1YnxGkpkWK1HF6hhy/it/
u=702257389 , 1274025419&fm=27gp=0.jpg "区块链")
markdown格式追求的是简单、多平台统一。所以需要图床,提供统一的外链,这样在不同的平台去处理图片的问题就可以统一处理了。

六、超链接

语法:

1
2
[超链接名](超链接地址 "超链接title")
title可加可不加

七、列表

无序列表

用-+*任何一种都可以

示例:

1
2
3
- 列表内容
+ 列表内容
* 列表内容
注意:- + * 跟内容之间都要有一个空格

有序列表

数字加点

1. 列表内容
2. 列表内容
3. 列表内容

注意:序号与内容之间有空格

列表嵌套

上一级和下一级列表之间敲三个空格即可。

示例:

1. 一级列表


- 二级列表
- 二级列表
- 二级列表

八 输入拼音

声调 格式 效果
一声 ā ā
二声 á á
三声 ě ě
四声 è è
U音 ö ö

用法: 替换&后的第一个字母即可。有的字母替换后显示会不正常,自己尝试一下即可。

九 表格

语法:

1 表头|表头|表头
2 ---|:--:|---:
3 内容|内容|内容
4 内容|内容|内容

第二行分割表头和内容。
- 有一个就行,为了对齐,多加了几个 
文字默认居左
- 两边加:表示文字居中
- 右边加:表示文字居右
注意:原生的语法两边都要用 | 包起来。此处省略了

十 代码

单行代码

代码之间分别用一个反引号包起来

1 '代码内容'

代码块

代码之间分别用三个反引号包起来,且两边的反引号单独占一行

1
2
3
4
5
6
7
8
9
###flow
st=>start: 开始
op=>operation: My Operation
cond=>condition: Yes or No?
e=>end
st->op->cond
cond(yes)->e
cond(no)->op
###

注意:为了防止转译,上述代码中使用#取代了单反引号,实际代码应当改为三个反单引号。

十一 流程图

注意:在写这篇博客时,上述流程图并未能成功显示,原因在于当初所参考的代码有误,流程图应当以三个单反引号开始,紧接flow,代码前不应当有空格。于2021年7月12日下午,测试完成此次流程图展示。

十二 折叠内容

折叠内容
1
2
3
<details> <summary>Title</summary>
contents ...
</details>

内容里面可以嵌套使用 Markdown 语法和 HTML 语法。

效果

Title contents ...