Markdown
段落和换行
「由一个或多个连续的文本行组成」这句话其实暗示了 Markdown 允许段落内的强迫换行(插入换行符),so如果你确实想要依赖 Markdown 来插入换行标签的话,在插入处先按入两个以上的空格然后回车
标题
#标题一
##标题二
###标题三
####标题四
#####标题五
######标题六
强调
Markdown 使用星号和下划线作为标记强调字词的符号,被1个标记包围的字词会被转成用 em标签包围,用两个包起来的话,则会被转成 strong
_强调_
*强调*
**大强调**
***大大强调***
引用
> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.
列表
无序列表使用星号、加号或是减号作为列表标记:
* Red
* Green
* Blue
等同于:
+ Red
+ Green
+ Blue
也等同于:
- Red
- Green
- Blue
有序列表则使用数字接着一个英文句点:
1. Bird
2. McHale
3. Parish
行内代码
如果要标记一小段行内代码,你可以用反引号把它包起来(`),例如:
Use the `printf()` function.
代码区块
只要简单地缩进 4 个空格或是 1 个制表符就可以
这是一个普通段落:
这是一个代码区块。
分隔线
在一行中用三个以上的星号、减号、底线来建立一个分隔线
* * *
***
*****
- - -
链接
Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。
###行内式的链接
只要在方块括号后面紧接着圆括号并插入网址链接即可,链接的 title在网址后面,用双引号把 title 文字包起来即可,例如:
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
如果你是要链接到同样主机的资源,你可以使用相对路径:
See my [About](/about/) page for details.
参考式的链接
在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记:
This is [an example][id] reference-style link.
接着,在文件的任意处,你可以把这个标记的链接内容定义出来:
[id]: http://example.com/ "Optional Title Here"
隐式链接标记功能让你可以省略指定链接标记,这种情形下,链接标记会视为等同于链接文字,要用隐式链接标记只要在链接文字后面加上一个空的方括号,如果你要让 “Google” 链接到 google.com,你可以简化成:
[Google][]
然后定义链接内容:
[Google]: http://google.com/
下面是一个参考式链接的范例:
I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].
[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"
如果改成用链接名称的方式写:
I get 10 times more traffic from [Google][] than from
[Yahoo][] or [MSN][].
[google]: http://google.com/ "Google"
[yahoo]: http://search.yahoo.com/ "Yahoo Search"
[msn]: http://search.msn.com/ "MSN Search"
图片
Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。
行内式
![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")
###参考式
![Alt text][id]
「id」是图片参考的名称,图片参考的定义方式则和连结参考一样:
[id]: url/to/image "Optional title attribute"
自动链接
用尖括号将网址和电子邮件信箱包起来会自动转成链接。一般网址的链接文字就和链接地址一样,例如:
<http://example.com/>
Markdown 会转为:
<a href="http://example.com/">http://example.com/</a>
Referrence: http://wowubuntu.com/markdown/