Markdown基本语法
目录
概述
Markdown是John Gruber于2004年创建的轻量级标记语言,它允许人们使用易读易写的纯文本格式来编写文档,然后转换成为HTML和许多其他格式的文件,比如将Markdown转换成PDF,HTML。Markdown通常用于格式化README文件,用于在线论坛中撰写邮件等,比如GitHub上的README文档。下面来介绍一下常用的Markdown语法。
语法
1. 标题
Markdown有两种语法来写标题
- 用特定数量的
#
来实现:
# 标题一
## 标题二
### 标题三
- 用
=
(最高阶标题)和-
(第二阶标题)
标题一
===========
标题二
-----------
2. 列表
列表分为有序列表和无序列表,顾名思义就是分为有序号和无序号两种列表
1. 无序列表
无序列表使用的时候,在文字前面加上 -
或 *
或 +
* 无序列表
* 无序列表
* 无序列表
预览结果:
- 无序列表一
- 无序列表二
- 无序列表三
2. 有序列表
有序列表使用的时候,在文字前面加上 1. 2. 3.
1. 有序列表一
2. 有序列表二
3. 有序列表三
预览结果:
- 有序列表一
- 有序列表二
- 有序列表三
3. 引用
在文字前面加上 >
即可
> 博观而约取,厚积而薄发
预览结果:
博观而约取,厚积而薄发
使用嵌套引用
> 博观而约取,厚积而薄发
>> 博观而约取,厚积而薄发
预览结果:
博观而约取,厚积而薄发
博观而约取,厚积而薄发
这里可能看的不是很明显
使用嵌套列表
> * 嵌套列表一
> * 嵌套列表二
> * 嵌套列表三
> * 嵌套子列表一
> * 嵌套子列表二
预览结果:
- 嵌套列表一
- 嵌套列表二
- 嵌套列表三
- 嵌套子列表一
- 嵌套子列表二
注意:无序子列表中与上面的 *
要有四个空格,也就是说距离前面的 >
要有五个空格(加上 *
和 >
之间的空格)
4. 代码区块
在文章中添加代码,如果代码只有一行,可以用 `
字符将代码包括;如果代码多行,可以用 ```
将代码包括,比如:
```C
#include <stdio.h>
#include <stdlib.h>
int main(int argc, char const *argv[])
{
printf("hello world\n");
return 0;
}
```
预览结果是这样的
#include <stdio.h>
#include <stdlib.h>
int main(int argc, char const *argv[])
{
printf("hello world\n");
return 0;
}
注意:第一个```
后面跟的是语言类型,这里的例子是C语言,所以上面写着C
5. 斜体和粗体
- 斜体
用一个 *
或 _
将文字包括,下面使用的星号:
*斜体*
斜体
- 粗体
用两个 *
或 _
将文字包括,下面使用的星号:
**粗体**
预览结果:
粗体
6. 删除线
使用两个 ~
将文字包括,比如:
~~删除线~~
预览结果:
删除线
7. 空格
- 半角空格(英文)
- 全角空格(中文)
 
8. 分割线
分割线有三种,字符之间可以有一个空格相隔
- 三个或更多个星号组合
- 三个或更多个减号组合
- 三个或多个下划线组合
星号:
*************
减号:
-------------
下划线:
_____________
或:
星号和空格相隔:
* * * * * * * * * *
减号和空格相隔:
- - - - - - - - - -
下划线和空格相隔:
_ _ _ _ _ _ _ _ _ _
预览结果是这样的:
星号:
减号:
下划线:
或:
星号和空格相隔:
减号和空格相隔:
下划线和空格相隔:
9. 插入链接
[]()
注意:其中中括号是文字,小括号是链接地址
10. 插入图片
![]()
注意:其中小括号是图片的链接地址
结语
上面这些是Markdown的基本语法,还有一些高级的语法比如表格,标签分类,待办事宜,流程图等等。暂时先写着这些,以后用得上更高级的语法的时候在补上。