Makedown 的简明语法
区块元素
段落和换行
段落前后要有一个以上的空行,单纯的回车空行在markdown中是不可行的,添加空行或回车,应当在插入处先按入两个以上的空格然后回车。
标题
Markdown支持两种标题的语法,类Setext和类atx形式。
类Setext形式是用底线的形式,利用
=(最高阶标题)和-(第二阶标题),例如:
This is an H1 .
This is an H2 .可以是任何数量的
=和-。类Atx形式是在行首插入1到6个
#,对应标题的1到6阶,例如:
这是H1
这是H3这是H6
区块引用Blockquotes
Markdown标记区块引用是使用类似email中用>的引用方式,如:
This is a blockquote with two paragraphs.
Donec sit amet nisl. 也可以在整个段落的第一行最前面加一个
>。同时区块引用是可以嵌套的,区块内可以使用Markdown的语法。
列表
Markdown支持有序列表和无序列表。 无序列表使用星号、加号或是减号作为列表标记:
red
green
blue
等同于 :
red
green
blue
有序列表则使用数字接着一个英文句点:
Bird
McHale
Parish
行首出现‘数字-句点-空白’,如果要避免,可以在句点前面加上\。
代码区块
Markdown中建立代码区块,需要缩进4个空格或是一个制表符,例如:
分隔线
可以使用三个以上的星号、减号、底线来建立分隔线,行内不能有其他东西,也可以在星号或者减号中间插入空格,如下:
区段元素
链接
Markdown支持两种形式的链接语法:行内式和参考式两种形式,两种链接文字都用[方括号]来标记。 行内式:
参考式,是在链接文字后面再接上另一个方括号,用以填入辨识链接的标记:
This is an example reference-style link .
接着,在文件任意处,将这个标记的链接内容定义出来,定义不能放在引用之中: 隐式链接标记功能可以省略指定的链接标记,这时,链接标记被视为链接文字,如:
Google , a search engine.
强调Markdown使用
*和底线_作为标记强调字词的符号,单个会转成斜体,两个则是加粗,如下: one one two two 同样,如果插入普通的星号或底线,可以使用反斜线。
代码
标记一小段行内代码,可以使用反引号(` )将其包起来,如:
Use the
printf()function . Please don't use<blink>tags.
如果要在代码区段内插入反引号,可以用多个反引号来开启和结束代码区段:
There is a literal backtick (`) here.
图片
Markdown 使用类似链接的语法来标记图片,同样也有两种样式:行内式和参考式。 行内式的图片语法看起来是:
参考式的图片语法为:
目前无法指定图片的宽高,因此如果有必要,使用标签。
其它
自动链接
Markdown 支持简短的自动链接的形式处理网址和电子邮件信箱,通过方括号(<>)包起来,如:
最后更新于
