Markdown概述
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,在 2004 由约翰·格鲁伯(英语:John Gruber)创建。Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。Markdown 编写的文档后缀为 .md, .markdown。Markdown 能被使用来撰写电子书,如:Gitbook。此外,当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。
标题
在 Markdown 中,在文本前面加上 # 即为标题。同理,你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加 # 即可,标题字号相应降低。
注:# 和标题之间建议保留一个字符的空格,这是最标准的 Markdown 写法。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
显示为:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
还有第二种表示标题的方式,使用=和-作为标记(三个以上),比如:
一级标题
===
二级标题
---
显示为:
一级标题
二级标题
列表
列表则是在文字前面加上-/+/*
的一种就可以了,符号和后面内容间加个空格,此外列表也可以嵌套(在最前面加上三个空格即可),比如:
#无序列表
- 叙述一
1. 分段一
2. 分段二
3. 分段三
+ 叙述二
* 叙述三
#有序列表
1. 叙述一
+ 分段一
2. 叙述二
3. 叙述三
显示为:
- 叙述一
- 分段一
- 分段二
- 分段三
- 叙述二
- 叙述三
- 叙述一
- 分段一
- 叙述二
- 叙述三
链接和图片
Markdown中插入链接只需要使用[标记文本](链接地址) "链接名称"
即可,其中链接名称可省略比如:
[百度](www.baidu.com)
显示为:
百度
图片与链接类似,使用![图片名](图片链接地址 "图片名")
即可,其中地址后的图片名指鼠标悬停时显示的图片名,可以省略。插入图片的地址需要图床,想了解的可以参考markdown图床。可以按下面的方式插入图片:
![贾宝玉和林黛玉](https://upload-images.jianshu.io/upload_images/16691637-74e1cd2cb25327df.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
显示为:
此外可以使用变量代替链接的地址,转而在文档末尾变量赋值作为地址,比如
我们用变量baidu代替地址的值,[百度][baidu]
也可以用变量1代替谷歌的地址,[谷歌][1]
[baidu]: http://www.baidu.com/
[1]: http://www.google.com
简书貌似不支持显示,这里就不做演示了
引用
在文章中引用别人的文字或者想要特别显示的文字,就可以使用> 文字
来插入引用,并且引用可以嵌套>> 文字
,利用嵌套可以实现一定的格式控制。此外,可以在列表中使用引用(>
前面要有四个空格)或者在引用中使用列表。比如:
>这世上本没有路,走的人多了便成了路
>
>静夜思
>>床前明月光,
>>疑是地上霜。
-列表中使用引用
>前面需要有四个空格
>前面需要有四个空格
>>
>引用中的列表
>1. 第一条
>2. 第二条
>- 列表内容
>
列表中带有引用
1. 第一条
>前面要有四个空格
2. 第二条
显示为:
这世上本没有路,走的人多了便成了路
静夜思
床前明月光,
疑是地上霜。引用中的列表
- 第一条
- 第二条
- 列表内容
列表中带有引用
- 第一条
前面要有四个空格
- 第二条
字体设置
在Markdown中设置字体也很简单,使用*
和_
隔开要修改字体的文字即可,显示斜体使用*文字*
或_文字_
(一个*
或_
),粗体使用**文字**
或者__文字__
(两个*
或_
),粗体倾斜使用***文字***
或___文字___
(三个*
或_
),删除字体使用~~文字~~
,下划线则要使用HTML中的<u>
标签,脚注使用[^标注文字]来添加比如:
这是一段文字,*这是斜体*,而**这是粗体**,***斜体加粗***,~~删除我吧~~。
这是一段脚注[^脚注]
[^脚注]: 这是一段脚注
显示为:
这是一段文字,这是斜体,而这是粗体,斜体加粗,删除我吧。
这是一段脚注[1]
插入代码块
需要插入代码块进行引用时,可以使用`扩起单行,使用```扩起多行(```放于首行和尾行),并且可以指定使用的语言(也可以不指定),也可以在每行代码之前加四个空格或一个tab
键(简书好像不行,可能需要设置tab
键等于四个空格)。当代码块内需要加入反引号时,只需最外层的单引号比内层的多就可以了。比如:
`单行引用`显示为这是单行引用
``` python(指定语言)
print("hello world!")
print("你好,世界!")
```
print("hello world!")
显示为:
print("hello world!")
print("你好,世界!")
print("hello world!")
在反引号内插入反引号(嵌套)
````
`print("hello world!")`
```
print("hello world!")
print("你好,世界!")
```
````
显示为:
`print("hello world!")`
```
print("hello world!")
print("你好,世界!")
```
分割线
三个及以上的-或*或_
即可形成分割线,比如:
---
----
***
___
显示为:
插入表格
使用|
分割不同的列,使用---:|:----:|:---
进行分隔表头和内容,其中冒号在左边表示左对齐,冒号在两边表示居中对齐,冒号在右边表示右对齐,默认没有冒号的时候是左对齐,而短横线-
的数量(至少一个)并不影响分隔效果,比如:
姓名 | 性别 | 年龄
-:|:----:|:---
小明 | 男 | 10
小丽 | 女 | 12
显示为:
姓名 | 性别 | 年龄 |
---|---|---|
小明 | 男 | 10 |
小丽 | 女 | 12 |
转义
Markdown中使用了很多符号,要想在文本中使用字符本身,则可以在字符前面加上反斜杠\
作为转义符。比如:
**粗体**
\*\*普通字体\*\*
显示为:
粗体
**普通字体**
支持转义的字符有:\ 反斜线
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 小括号
# 井号
+ 加号
- 减号
. 句点
! 感叹号
结语
个人学习笔记,仅供参考。
详细的教程可以参考菜鸟教程
-
这是一段脚注 ↩