基本概述
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
Markdown 语言在 2004 由约翰·格鲁伯(英语:John Gruber)创建。
Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。
Markdown 编写的文档后缀为 .md, .markdown。
标题
1、使用 = 和 – 标记一级和二级标题
= 和 – 标记语法格式如下:
这是一级标题
(输入文字并另起一行输入多个“=”上一行会自动变成一级标题)
这是二级标题
(输入文字并另起一行输入多个“-”上一行会自动变成二级标题)
2、使用 # 号标记
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
(注意:此种方式如果在 “#”后没有打空格,会变成标签。)
段落
Markdown 段落没有特殊的格式,直接编写文字就好,段落的换行是使用两个以上空格加上回车。
当然也可以在段落后面使用一个空行来表示重新开始一个段落。
例如:君不见黄河之水天上来,奔流到海不复回。
君不见高堂明镜悲白发,朝如青丝暮成雪。
人生得意须尽欢,莫使金樽空对月。
天生我材必有用,千金散尽还复来。
字体
斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本
(选中以查看格式)
分割线
可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你8也可以在星号或是减号中间插入空格。 *
* * *
*
– – –
———-
删除线
如果段落上的文字要添加删除线,只需要在文字的两端加上两个波浪线 “~”
例如:
RUNOOB.COM
GOOGLE.COMBAIDU.COM
下划线
下划线可以通过 HTML 的 \标签来实现: 带下划线文本
脚注
创建脚注格式类似这样 ^RUNOOB。
注意:在编辑板式下,上一行脚注并不会隐藏,只有在阅读板式下才会有鼠点击脚注出现脚注内容的功能,且在阅读板式下脚注内容会自动转移至笔记末端。
列表
Markdown 支持有序列表和无序列表。
无序列表
使用星号(*)、加号(+)或是减号(-)作为列表标记,这些标记后面要添加一个空格,然后再填写内容
例如:
* 第一项
* 第二项
* 第三项
+ 第一项
+ 第二项
+ 第三项
– 第一项
– 第二项
– 第三项
显示结果如下:
- 第一项
- 第二项
- 第三项
- 第一项
- 第二项
- 第三项
- 第一项
- 第二项
- 第三项
有序列表
有序列表使用数字并加上点号 . 号来表示
例如:
\1. 第一项
\2. 第二项
\3. 第三项
显示结果如下:
- 第一项
- 第二项
- 第三项
列表嵌套
列表嵌套只需在子列表中的选项前面添加两个或四个空格即可:
\1. 第一项:
\ – 第一项嵌套的第一个元素
\ – 第一项嵌套的第二个元素
\2. 第二项:
\ – 第二项嵌套的第一个元素
\ – 第二项嵌套的第二个元素
显示的结果如下:
- 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
- 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
注意:与python相同在markdown中Tab键也具有一键生成四个空格的作用。
区块
Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一个空格符号
单层区块
>这是第一行
>这是第二行
>这是第三行
显示结果如下:
区块引用
菜鸟教程
学的不仅是技术更是梦想
多层区块的嵌套
一个 > 符号是最外层,两个 > 符号是第一层嵌套,以此类推
> 最外层
> > 第一层嵌套
> > > 第二层嵌套
> > > >第三层嵌套
显示结果如下:
最外层
第一层嵌套
第二层嵌套
第三层嵌套
区块中使用列表
> 区块中使用列表
> 1. 第一项
> 2. 第二项
> + 第一项
> + 第二项
> + 第三项
显示结果如下:
区块中使用列表
- 第一项
- 第二项
- 第一项
- 第二项
+第三项
注意:obsidian并不能正确的识别在区块中含有列表是的语法,所以输出结果是只有区块而没有列表的。
列表中使用区块
如果要在列表项目内放进区块,那么就需要在 > 前添加四个空格的缩进。
列表中使用区块实例如下:
* 第一项
>
>
* 第二项
显示结果如下:
- 第一项
>
> - 第二项