Markdown是一种轻量级标记语言, 它允许人们使用易读易写的纯文本格式]编写文档,然后转换成有效的XHTML(或者HTML)文档。
由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息。
1. 标题
在标题前添加**#即可创建一个标题,#**的个数取决于标题的等级。(建议养成在#后添加空格的习惯)
# 我是一级标题
## 我是二级标题
### 我是三级标题
#### 我是四级标题
效果如下:
我是一级标题
我是二级标题
我是三级标题
我是四级标题
2. 段落
使用空行来分隔一个或多个文本行即可创建段落。
我是第一段,后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话。
我是第二段,后面也都是废话后面也都是废话后面也都是废话后面也都是废话后面也都是废话后面也都是废话后面也都是废话后面也都是废话后面也都是废话后面也都是废话后面也都是废话后面也都是废话。
效果如下:
我是第一段,后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话后面都是一些废话。
我是第二段,后面也都是废话后面也都是废话后面也都是废话后面也都是废话后面也都是废话后面也都是废话后面也都是废话后面也都是废话后面也都是废话后面也都是废话后面也都是废话后面也都是废话。
3. 换行
想要创建新的一行或者换行,用两个或多个空格结束一行,然后再输入回车。
我是第一行,我的后面有两个空格。
我是第二行,我成功换行了。
我是第一行,我的后面有两个空格。
我是第二行,我成功换行了。
4. 字体:粗体与斜体
使用一组*使文本斜体化。
使用一组**使文本加粗。
使用一组***使文本及加粗又斜体。
我后面的文字被**加粗了**。
*我是斜体字*
***又斜又粗***
我后面的文字被加粗了。
我是斜体字
又斜又粗
5. 引用
在一段文字前加上 > 即可创建引用。
> 我引用了一句话。
效果:
我引用了一句话。
多行引用也是可以的!
> 第一行引用。
> 又一行。
> 再一行。
第一行引用。 又一行。 再一行。
甚至还可以在引用中嵌套引用,语法是相通的。
> 普通的引用。
>> 套娃引用。
>>> 继续套,无限套。
普通的引用。
套娃引用。
继续套,无限套。
将上面学到的语法灵活运用:
> ### Markdown非常方便。
> 在**Markdown**中,一切都活变得*简单*。
>> 终于可以扔掉word了!
Markdown非常方便。
在Markdown中,一切都活变得简单。
终于可以扔掉word了!
6. 列表/清单
有序列表
创建一个有序列表只需在各个元素前加上一个数字并在数字后跟上一个点,如:1.
1. 第一点
2. 第二点
3. 第三点
- 第一点
- 第二点
- 第三点
甚至你可以不在乎数字是否按照顺序,只要保证第一点是1即可。
1. 第一
1. 第二点
8. 第三点
2. 第四点
- 第一点
- 第二点
- 第三点
- 第四点
添加缩进即可在大点后面添加小点:
1. 第一大点
1. 第一小点
2. 第二小点
2. 第二大点
- 第一大点
- 第一小点
- 第二小点
- 第二大点
无序列表
只需在每一点前加上一个 - 即可创建无序列。
- 第一点
- 第二点
- 第一小点
- 第二小点
- 第三点
- 第一点
- 第二点
- 第一小点
- 第二小点
- 第三点
7. 代码块
在一组**```之间添加代码即可创建代码块,并且还可以添加语言**实现代码高亮。
```C
# include <stdio.h>
int main()
{
printf("Hello Markdown!");
}
```
效果如下:
# include <stdio.h>
int main()
{
printf("Hello Markdown!");
}
print("Hello Markdown!")
8. 添加图片
添加图片的具体语法是:![描述文字](图片地址)
- 其中图片地址即可一是url地址,也可以是本地目录。
- 因为Markdown文件无法储存图片,所以建议将Markdown文件中的图片都上传至图床。
例子:
![这是一张图片](https://imgbed.codingkelvin.fun/uPic/tT4NGx.png)
9. 水平线
为了分割文档内容,有时需要添加一条水平线。在新的一行输入 --- 即可创建一条水平线。
---
我上下各有一条水平线
---
我上下各有一条水平线。
10. 超链接
创建超链接的具体语法是:[描述文字](链接)
例子:
点我跳转到 [博客首页](https://codingkelvin.fun)
点我跳转到 博客首页
11. 邮箱与链接地址
想要快速将邮箱与链接地址变为一个可点击的链接,只需在链接两侧加上**<>**。
<https://codingkelvin.fun>
<kelvinqiu802@outlook.com>
https://codingkelvin.fun kelvinqiu802@outlook.com
12. 灵活运用
Markdown的语法非常灵活,几乎所有语法都可以混合在一起使用,一下将举一个例子来打开大家的思路。
图片链接:点击图片即可跳转到一个链接
原理:只需将超链接文字描述的内容换成一张图片
[![我是一张图片](https://imgbed.codingkelvin.fun/uPic/tT4NGx.png)](https://codingkelvin.fun)
参考文章:
Markdown Guide: Basic Syntax