换行
需要换行的话在行末尾加上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/。