markdown语法小结


换行

需要换行的话在行末尾加上2个以上的空格就可以了。

标题

Markdown支持两种标题的语法,类Setext和类atx形式。
类Setext使用=(最高阶标题)和-(第二阶标题)。
类atx通过在行首插入1到6个#,对应到标题的1到6阶。

区块引用

标记引用使用>。就好象下面这样

I'm sad.

列表

无序列表使用星号,加号或者减号作为列表标记。
有序列表则使用数字接着一个英文句点。如下所示


1. Red
2. Green
3. Blue

代码区块

要在Markdown中建立代码区块很简单,只要简单地缩进4个空格或是一个制表符就可以了。这个每行一阶的缩进都会被移除,转化为标签。如果在代码区块之前有文字的话,你必须先空一行,jekyll才会转化,否则是不转化的。

分隔线

你可以在一行中用三个以上的星号,减号或底线来建立一个分隔线,行内不能有其他符号。你也可以在星号或者减号中间插入空格。


链接

Markdown支持两种形式的链接语法:行内式和参考式两种形式。不管是哪一种,链接文字都是用[方括号]来标记。
要建立一个行内式的链接,只要在方括号后面紧接着圆括号并插入网址即可,如果你还想加上链接的title文字,只要在网址后面,用双引号把title文字包起来即可。
参考式的链接实在链接文字的括号后面再接另一个方括号,而在第二个方括号里面填入用以辨识链接的标记。接着在文件的任意处,你可以把这个标记的链接内容定义出来.

[id]: http://example.com "Optional Title Here"

强调

Markdown使用星号和底线作为强调字词的符号,被 * 或 _ 包围的字词会被转成用<em>标签包围,用两个* 或者 _ 包围的字词会被转成用<strong>
但是,如果你的 * 和_ 两边都有空格的话,它们就只会被当成普通的符号。如果要在文字前后直接插入普通的星号或底线,你可以用反斜线。

代码

如果要标记一小段行内代码,你可以用反引号把它包起来。
如果你要在代码区段内插入反引号,你可以用多个反引号来开启和结束代码区段。
在代码区段内,&和方括号都被自动转换成HTML实体,这使得插入HTML原始码变得很容易。

图片

Markdown使用一种和链接很相似的语法来标记图片,同样也允许两种样式:行内式和参考式。
行内式的图片语法看起来是:

![Alt text](/path/to/img.jpg)   
![Alt text](/path/to/img.jpg "Optional title")   

详细叙述如下:
一个惊叹号! 接着一个方括号,里面放上图片的替代文字 *接着一个括号,里面网上图片的地址,最后还可以用引号包住并加上选择性的‘title’文字。 参考式的图片语法长这样:

![Alt text][id]

id是图片参考的名称,图片参考的定义方式和链接参考一样:

[id]: url/to/image "Optional title attribute"

自动链接

Markdown支持以不交简短的自动链接形式来处理网址和电子邮件信箱。

<http://example.com>

反斜杠

Markdown可以利用反斜杠来插入一些在语法中有其它意义的符号,相当于代码里面的转义符。
Markdown支持以下这些符号前面加上反斜杠来帮助插入普通符号。
\ ` * _ {} [] () # + - . !

备注

本文使用Markdown来编写,主要是把Markdown中文语法说明的中文版精炼了一下,原文请关注http://wowubuntu.com/markdown/

KyleZhao /
Published under (CC) BY-NC-SA in categories tagged with