MarkDown常用语法介绍
学习过的内容总要不断的强化,之前只是看过一些markdown的写法,并未真正写过md文档。最近,需要写一些GitHub文档,就深入学习MarkDown的写法,并汇总了这一份文档,且用MarkDown编辑。本文将会介绍一些MarkDown的基本标记语法以及一些常用图形的绘制,包括流程图、甘特图。
MarkDown是一种轻量级标记语言,以一种纯文本的形式编辑,最终可转化为HTML格式发布,能够让编写者沉浸其中,享受文档编写的快乐。
本文目录
一、基本用法
一、基本用法
标题
加在文本前面,将#
后的文本作为标题。可实现h1-h6六级标题,按照#的个数区分标题等级。
例如:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
显示效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
区块引用
当你想要单独引用某一段落,就要用到MarkDown中的区块应用>
符号,并且可以叠加多个>
嵌套使用。
例如:
> 曾经有一份真挚的爱情摆在我面前,我没有珍惜,等到失去了才后悔莫及。(区块引用)
>> 如果再给我一次机会,我想对那个女孩子说三个字。。。 (嵌套引用)
显示效果:
> 曾经有一份真挚的爱情摆在我面前,我没有珍惜,等到失去了才后悔莫及。
>> 如果再给我一次机会,我想对那个女孩子说三个字。。。
注意: > 和 文本之前记得保留一个空格。
列表
这里的列表是指分条列举,在编辑时,只需要将-
加在每行的前面即可,
例如:
- 例子1,我说。。。
- 例子2,我说。。。
- 例子3,我说。。。
- 例子4,我说。。。- 例子4的介绍。。。。
显示效果:
例子1,我说。。。
例子2,我说。。。
例子3,我说。。。
-
例子4,我说。。。
- 例子4的介绍。。。。
如果想要将前面的原点换成数字,变成有序列表,那就在每行前面加 1. 2. 3. 即可。
例如:
1. 例子1,我说。。。
2. 例子2,我说。。。
3. 例子3,我说。。。
4. 例子4,我说。。。
4.1 例子4的介绍。。。
显示效果:
- 例子1,我说。。。
- 例子2,我说。。。
- 例子3,我说。。。
- 例子4,我说。。。
4.1 例子4的介绍。。。
粗体和斜体
粗体或者斜体的使用就更简单了,只需要在需要强调的文本左右加上*
或者_
。
例如:
*我是谁*(
斜体
)
_我在哪儿_ (斜体
)
**我是谁**(粗体
)
__我在哪儿__ (粗体
)
显示效果:
我是谁(
斜体
)
我在哪儿 (斜体
)
我是谁(粗体
)
我在哪儿 (粗体
)
代码引用
代码引用的时候,需要在每个代码行前面加一个Tab或者4个空格,也可以使用
, 单行使用
包裹,多行使用
```
包裹代码,效果与tab相同。
例如:
普通段落
function add (x, y) {
return x + y;
}
代码块:
function add (x, y) {
return x + y;
}
function () {
}
链接与图片
链接和图片的添加方法类似,方法有两种行内式和参数式。(也可使用html的方法,通过<a></a>添加)
链接:
[我是Github,请点我](https://github.com/HamsinD/MarkDown_summary) (
行内式
)
效果:我是Github,请点我
[我是Github,请点我](Github) (
参数式
)
[Github](https://github.com/HamsinD/MarkDown_summary)
效果:
我是Github,请点我
添加图片只需要在链接的格式前面加!
。
图片:
表格
表格的写法比较有意思,通过|
和-
来绘制表格,具体看写法:
| tab1 | tab2 | tab3 |
| ---------- |:--------:| -------:|
| xxxxxxx | xxxxxxx | xxxxxxx |
| xxxxxxx | xxxxxxx | xxxxxxx |
显示效果:
tab1 | tab2 | tab3 |
---|---|---|
xxxxxxx | xxxxxxx | xxxxxxx |
xxxxxxx | xxxxxxx | xxxxxxx |
注意: 表头线-
两侧的:
用来设置居中方式。
注意点:
- 段落的前后要有空行,所谓的空行是指没有文字内容。若想在段内强制换行的方式是使用两个以上空格加上回车(引用中换行省略回车)。
- 一个空格输入
即可