1. 标题
MarkDown语法和Html语法有一定的相似性,比如对于标题的定义,不论是MarkDown还是Html都分了6级。不同的是MarkDown是使用#号来进行标示。
具体格式为# 内容或者 # 内容 #,这两个语法等效,后者在某些场合应为表明了起始位置而显得更易阅读。其中#号的数量标示了标题的级别,1个#对应1级标题,2个#号对应2级标题。具体示例如下:
2. 分割线
MarkDown的分割线书写方式十分自然,和平时在电脑上进行文字编辑时输入分割线的方式基本一致。只需要连续的输入3个以上-或者*即可。如下所示:
3. 列表
MarkDown的列表语法看上去也十分自然,无需列表以* 空格,+ 空格,或者- 空格开头,而有序列表以数字. 空格开头。并且有序列表并不关注数字的内容,只需要时数字,即可按照顺序进行排序编号。如下所示:
4. 超链接
MarkDown的超链接的语法格式虽然有两种,但是作为常用语法来说[描述](链接地址)这样的语法更容易被人们接受。如下所示:
5. 引用
MarkDown使用>符号来作为引用段落的标示。引用的段落会用明显的标示与正文进行区分。不过在引用段落内,一个回车符并不能让文本内容按照期望换行,仅仅只是加入了一个空格字符而已。如果需要让文本内容换行,那么需要输入两个回车符。如下所示:
6. 代码
作为一个开发人员,无法避免的需要在文本中插入代码。在很多其他编辑器中,插入代码并设置代码格式,其实并不是一件容易的事儿。不过在MarkDown这里,不得不为代码插入点个赞。仅仅使用两个制表符,就可以完成代码的插入。
如果是再行内插入代码,则使用成对出现的反引号`表示代码,
如下所示:
7. 粗体和斜体
在MarkDown语法中,使用不同数量的*内容*号即可设定文字是粗体、斜体、或者两者都是。
- 1个*号代表斜体
- 2个*号代表粗体
- 3个*号代表斜体+粗体
如下所示:
8. 图片
MarkDown中插入图片的语法是![描述](图片地址 "图片替代文本")。
其中描述在不同的MarkDown编辑器里有不同的效果,有的编辑器并不会显示出描述的文本内容。
图片替代文本就是HTML中<img>标签中的alt属性,这是在图片无法显示时的替代文本,也是用于描述图片内容的属性。
目前MarkDown语法暂时无法定于图片大小,如果需要定于图片大小,可以使用HTML语言中的<img>标签。
具体示例如下所示:
9. 表格
MarkDown中的表格制作略显复杂,但是这个复杂仅仅是对于用惯了Office系列软件的人们而言。其实就语法而言,MarkDown的表格制作依然是简单到只要让人看一眼表格制作的示例,就能明白如何制作表格的程度。这里先提几个概念:
- 符号|是表格中每一列单元格的分割。
- 通常一行没有回车符的文本就代表表格中的一行。
- 表格头和表格体使用-------进行分割,其中-的数量应该大于或等于3个。
- 在第3点钟的符号前后可以加入:设定单元格的对齐方式。
- 不加:时,表示默认的左对齐。
- 在前后都加:时,表示水平居中对其。
- 在尾部加:时,表示右对齐。
- 在单元格内换行,可以使用<br/>进行换行操作。
- 每一行的列数允许少于总列数。
10. 自动转换
MarkDown已经足够的智能,可以使用<可识别内容>的语法,通过<>来完成自动转换。例如:
11. 其他
- 如果不能换行,可以尝试多敲几次回车
- 如果还是不能换行,可以试试<br/>
- MarkDown已经足够的智能,可以在大多数情况下正确识别<>,&,.,以及单双引号所需要的格式。
- 如果不能正确识别<>,&,.,以及单双引号所需要的格式,那么可是使用反斜杠作为转移符使用