因为博客是使用Markdown编辑的,此文仅作查询备用之用途。
Markdown介绍
Markdown是一种轻量级标记语言,创始人为John Gruber。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。[4]这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。 由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,当前许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息。如_GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书_等,甚至还能被使用来撰写电子书。
格式
Markdown语法主要分为如下几大部分: 标题,段落,区块引用,代码区块,强调,列表,分割线,链接,图片,反斜杠 \,符号'`'。
标题
1)使用=
和-
标记一级和二级标题。
1 | 一级标题 |
效果:
一级标题
二级标题
2)使用#
,可表示1-6级标题(注意#和标题中间有空格)
1 | # 一级标题 |
效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
段落
段落的前后要有空行,所谓的空行是指没有文字内容。若想在段内强制换行的方式是使用两个以上空格加上回车(引用中换行省略回车)。
区块引用
在段落的每行或者只在第一行使用符号>
,还可使用多个嵌套引用,如:
1 | > 区块引用 |
效果:
区块引用
嵌套引用
代码区块
代码区块的建立是在每行加上4个空格或者一个制表符(如同写代码一样)。如 普通段落:
1 | void main() %注意前面有4个空格 |
代码区块:
1 | void main() |
注意:需要和普通段落之间存在空行。
强调
在强调内容两侧分别加上*
或者_
,如
1 | *斜体*,_斜体_ |
效果: 斜体,斜体 粗体,粗体 斜粗体,斜粗体
列表
使用·
、+
、或-
标记无序列表,如:
1 | -(+*) 第一项 -(+*) 第二项 - (+*)第三项 |
注意:标记后面最少有一个_空格_或_制表符_。若不在引用区块中,必须和前方段落之间存在空行。 效果:
- 第一项
- 第二项
- 第三项
有序列表的标记方式是将上述的符号换成数字,并辅以.,
如:
1 | 1. 第一项 |
效果:
- 第一项
- 第二项
- 第三项
分割线
分割线最常使用就是三个或以上*,还可以使用-和_。
链接
使用 [描述](链接地址)
为文字增加外链接。 举例:
1 | [Ekkles的博客](https://www.ekkles.com) |
效果: Ekkles的博客
图片
添加图片的形式和链接相似,只需在链接的基础上前方加一个!。 例子:
1 | ![zybuluo](https://www.zybuluo.com/static//img/my_head.jpg) |
效果:
反斜杠\
相当于反转义作用。使符号成为普通符号。
删除线
使用 ~~
表示删除线。 这是一段错误的文本。
表格
Markdown的表格比较麻烦,格式如下
要添加表,使用三个或多个连字符(---)创建每列的标题,并使用竖杠(|)分隔每列。您可以选择在表的任一端添加竖杠。
1
2
3
4| Syntax | Description |
| ----------- | ----------- |
| Header | Title |
| Paragraph | Text |
呈现的输出如下所示:
Syntax | Description |
---|---|
Header | Title |
Paragraph | Text |
同时,还可以根据需求不同,有其他的格式设置,如对齐,可以对标题行的左侧、右侧或两侧同时添加冒号(:),分别对应于左对齐、右对齐、居中对齐。
由于Markdown的表格相对繁琐,这里更推荐使用网页工具一键转换。 比如https://markdown-convert.com/zh/tool/table等
参考资料
Markdown-Wikipedia:https://zh.wikipedia.org/wiki/Markdown
Markdown 基本语法:https://github.com/younghz/Markdown