Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(英语:John Gruber)。由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,当前许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息。如GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等,甚至还能被使用来撰写电子书。——Wikipedia
Markdown支持两种形式的标题, Setext和atx。
Setext只支持一级和二级标题,atx支持一级到六级标题,且更方便。
atx使用#
号可表示 1-6 级标题,一级标题对应一个#
号,二级标题对应两个#
号,以此类推(#
与标题之间应有空格space)。举个栗子:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
显示效果:
Markdown 段落没有特殊的格式,直接写就完事了。段落换行有两种方式,一是使用两个以上空格加回车;二是段落后面直接插入一个空行表示重新开始一个段落。我喜欢第二种方式,这样可以使得Markdown文件看起来更加简洁,清晰。举个栗子:
使用两个以上空格space加回车:
这是第一个段落。spacespace
这是第二个段落。
显示效果:
这是第一个段落。
这是第二个段落。
段落后面直接插入一个空行表示重新开始一个段落:
这是第一个段落。
这是第二个段落。
显示效果:
这是第一个段落。
这是第二个段落。
Markdown可以使用斜体、粗体、粗斜体。举个栗子:
*斜体*
**粗体**
***粗斜体***
显示效果:
斜体
粗体
粗斜体
可以在一行中用三个以上的星号、减号或下划线来建立一个分隔线,行内不能有其他东西。也可以在星号或是减号中间插入空格space。举个栗子:
***
---
___
显示效果:
要使用删除线,只需要在文字的两端加上两个波浪线~~
即可。举个栗子:
这句话后面是我要删除的文字:~~这是我要删除的文字。~~
显示效果:
这句话后面是我要删除的文字:这是我要删除的文字。
下划线使用标签即可。举个栗子:
这是带有下划线的文字。
显示效果:
这是带有下划线的文字。
脚注是对文本的补充说明。举个栗子:
这是一个脚注 [^脚注举例]。
[^脚注举例]:脚注1
显示效果:
这是一个脚注 1。
老夫聊发少年狂,左牵黄,右擎苍,锦帽貂裘,千骑卷平冈。为报倾城随太守,亲射虎,看孙郎。
酒酣胸胆尚开张,鬓微霜,又何妨!持节云中,何日遣冯唐?会挽雕弓如满月,西北望,射天狼。
Markdown 支持有序列表和无序列表。
无序列表使用星号*
、加号+
或是减号-
来表示(后面要加空格space),举个栗子:
* 第一
* 第二
* 第三
显示效果:
有序列表使用数字并加上.
号来表示(后面要加空格space),举个栗子:
1. 第一
2. 第二
3. 第三
显示效果:
列表嵌套只需在子列表中的选项前添加四个空格space或者一个制表符TABTAB即可,举个栗子:
1. 第一项
* 第一项中的第一项
* 第一项中的第二项
1. 第二项
* 第二项中的第一项
* 第二项中的第二项
显示效果:
第一项
第二项
Markdown 区块引用是在段落开头使用>
符号 ,然后后面紧跟一个空格space符号,举个栗子:
> 这是第一个区块
> 这是个例子
>这是第二个区块
显示效果:
这是第一个区块
这是个例子
这是第二个区块
此外,区块是可以嵌套的,举个栗子:
> 这是第一个区块
> > 这是第一个区块中嵌套的第二个区块
显示效果:
这是第一个区块
这是第一个区块中嵌套的第二个区块
> 区块中使用列表示例
> 1. 第一项
> 2. 第二项
> 3. 第三项
> * 第一项
> * 第二项
> * 第三项
显示效果:
区块中使用列表示例
- 第一项
- 第二项
- 第三项
- 第一项
- 第二项
- 第三项
要在列表项目内放进区块,那么就需要在使用区块>
前添加四个空格space或者制表符TABTAB的缩进,表示嵌套。举个栗子:
* 第一项
> 嵌套的区块
> 嵌套的区块
* 第二项
> 嵌套的区块1
> 嵌套的区块2
显示效果:
第一项
嵌套的区块
嵌套的区块
第二项
嵌套的区块1
嵌套的区块2
如果是段落上的一个函数或片段的代码可以用反引号把它包起来`,举个栗子:
`printf("Hello,World!")`可以输出Hello,World!
显示效果:
printf("Hello,World!")
可以输出Hello,World!
使用四个space或者一个制表符(TAB TAB键)可以使用代码块,举个栗子:。
#include
int main(){
printf("Hello,World!");
return 0;
}
Markdown支持两种链接形式:内联和引用。这两种形式下链接文本的定界符都是 [中括号]。
创建内联链接, 在链接文本的右括号后面紧接一对圆括号. 圆括号里面放所需的链接, 还可以放一个可选的链接标题, 标题要用引号包围。举个栗子:
这是一个小游戏的链接:[4399](https://www.4399.com)
这是一个小游戏的链接:[4399](https://www.4399.com "网页小游戏")
显示效果:
这是一个小游戏的链接:4399
这是一个小游戏的链接:4399
直接使用链接地址:
小游戏:https://www.4399.com
显示效果:
小游戏:https://www.4399.com
此外,可以通过变量设置链接,变量赋值可以放在文末。
这是这是一个网页小游戏的链接:[4399][1]
[1]: https://www.4399.com
显示效果”
这是这是一个网页小游戏的链接:4399
要引用图片,格式如下:
![alt 属性文本](图片地址)
或
![alt 属性文本](图片地址 "可选标题")
举个栗子:
这是APPLE的logo: ![APPLE的logo](https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1587325137362&di=16c3fa4bc59add48464ab9694d63e59a&imgtype=0&src=http%3A%2F%2Fimg0.imgtn.bdimg.com%2Fit%2Fu%3D4132696015%2C1964163191%26fm%3D214%26gp%3D0.jpg "APPLE")
显示效果:
这是APPLE的logo:[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-kMd9gG0j-1587532982721)(https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1587325137362&di=16c3fa4bc59add48464ab9694d63e59a&imgtype=0&src=http%3A%2F%2Fimg0.imgtn.bdimg.com%2Fit%2Fu%3D4132696015%2C1964163191%26fm%3D214%26gp%3D0.jpg “APPLE”)]
Markdoown使用|
来分隔单元格,使用-
来分隔表头和其他行。举个栗子:
|表头|表头|表头|
|-|-|-|
|单元格|单元格|单元格|
|单元格|单元格|单元格|
显示效果:
表头 | 表头 | 表头 |
---|---|---|
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
:-
设置内容和标题栏左对齐
-:
设置内容和标题栏右对齐
:-:
设置内容和标题栏剧中对齐
|左对齐|居中对齐|右对齐|
|:-|:-:|-:|
|单元格|单元格|单元格|
|单元格|单元格|单元格|
显示效果:
左对齐 | 居中对齐 | 右对齐 |
---|---|---|
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
\
来进行转义。$$
包裹 TeX 或 LaTeX 格式的数学公式来实现。比如:
c = a 2 + b x y 2 + e x c = \sqrt{a^{2}+b_{xy}^{2} +e^{x}} c=a2+bxy2+ex
脚注1 ↩︎
苏轼(1037年1月8日-1101年8月24日),字子瞻,和仲,号“东坡居士”,世称“苏东坡”。汉族,眉州人。北宋诗人、词人,宋代文学家,是豪放派词人的主要代表之一,“唐宋八大家”之一。 ↩︎