Markdown语法规范
特殊字符自动转换
在html中,有两个字符需要特殊处理:< 和 &。
< 符号用于起始标签, & 符号用于标记HTML实体。
要使用原型的话,必须使用 <
在makedown中,可以直接使用< 和 &,makedown会自动将其装换为html能识别的特殊字符
段落和换行
一个Makedown段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行。不同段落不该用空格和制表符来缩进。
如果确实要依赖Makedown来插入<br/>标签的话,在插入处先按入两个以上的空格然后回车。
标题
'=' 最高阶标题
'-' 第二阶标题
'#' 在行首插入1到6个#,对应的标题1到6阶
区块引用Blockquotes
'>' 在每行的最前面加入>,或者在整个段落的最前面加上>,区块引用可以嵌套,也可以是使用其他的Makedown语法,表壳标题、列表、代码区块等。
列表
Makedown支持有序列表和无序列表;
无序列表使用星号、加号或者减号最为列表标记:*,+,-;
有序列表则使用数字接着一个英文句点:1. ,2. ,...;
列表标记通常放在最左边,但是其实也可以缩进,最多3个空格;
项目标记后面则一定要接着至少一个空格或制表符。
在列表内项目内放进引用,那>就需要缩进;
如果要放代码区块的话,该区块就需要缩进两侧。
代码区块