摘自http://wowubuntu.com/markdown/语法说明 (简体中文版)
段落和换行
一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行。
标题
在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,例如:
1 | # 这是 H1 |
区块引用 Blockquotes
Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。如果你还熟悉在 email 信件中的引言部分,你就知道怎么在 Markdown 文件中建立一个区块引用,那会看起来像是你自己先断好行,然后在每行的最前面加上 > :
1 | > This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, |
Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :
1 | > This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, |
列表
Markdown 支持有序列表和无序列表。
无序列表使用星号、加号或是减号作为列表标记:
1 | * Red |
有序列表则使用数字接着一个英文句点:
1 | 1. Bird |
代码区块
和程序相关的写作或是标签语言原始码通常会有已经排版好的代码区块,通常这些区块我们并不希望它以一般段落文件的方式去排版,而是照原来的样子显示,Markdown 会用
和 标签来把代码区块包起来。
要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,例如,下面的输入:
1
2
3
这是一个普通段落:
这是一个代码区块。
Markdown 会转换成:
1
2
3
4
<p>这是一个普通段落:</p>
<pre><code>这是一个代码区块。
</code></pre>
别一种方式用三个反引号包起:
1
2
```
var foo = 1;
1
2
3
同时可以指定语言:
1
var foo = 1;
1
2
3
4
5
### 分隔线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
1
2
3
4
5
6
7
8
9
### 链接
Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。
不管是哪一种,链接文字都是用 [方括号] 来标记。
要建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可,例如:
This is an example inline link.
This link has no title attribute.
1
2
3
参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记:
This is an example reference-style link.
1
2
3
接着,在文件的任意处,你可以把这个标记的链接内容定义出来:
1
2
3
4
5
### 强调
Markdown 使用星号(*)和底线(_)作为标记强调字词的符号,被 * 或 _ 包围的字词会被转成用 <em> 标签包围,用两个 * 或 _ 包起来的话,则会被转成 <strong>,例如:
single asterisks
single underscores
double asterisks
double underscores
1
2
3
4
5
### 代码
如果要标记一小段行内代码,你可以用反引号把它包起来(`),例如:
Use the printf()
function.
1
2
3
4
5
6
7
8
9
### 图片
很明显地,要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。
Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。
行内式的图片语法看起来像是:


1
2
3
参考式的图片语法则长得像这样:

1
2
3
「id」是图片参考的名称,图片参考的定义方式则和连结参考一样: