Markdown

X分鐘速成Y

其中 Y=markdown

源代碼下載：?learnmarkdown-cn.md

Markdown 由 John Gruber 于 2004年創(chuàng)立. 它旨在成為一門容易讀寫的語法結(jié)構(gòu)，并可以便利地轉(zhuǎn)換成 HTML（以及其他很多）格式。

歡迎您多多反饋以及分支和請求合并。

<!-- Markdown 是 HTML 的父集，所以任何 HTML 文件都是有效的 Markdown。
這意味著我們可以在 Markdown 里使用任何 HTML 元素，比如注釋元素，
且不會(huì)被 Markdown 解析器所影響。不過如果你在 Markdown 文件內(nèi)創(chuàng)建了 HTML 元素，
你將無法在 HTML 元素的內(nèi)容中使用 Markdown 語法。-->

<!-- 在不同的解析器中，Markdown 的實(shí)現(xiàn)方法有所不同。
此教程會(huì)指出當(dāng)某功能是否通用及是否只對某一解析器有效。 -->

<!-- 標(biāo)頭 -->
<!-- 通過在文本前加上不同數(shù)量的hash(#), 你可以創(chuàng)建相對應(yīng)的 <h1> 
到 <h6> HTML元素。-->

# 這是一個(gè) <h1>
## 這是一個(gè) <h2>
### 這是一個(gè) <h3>
#### 這是一個(gè) <h4>
##### 這是一個(gè) <h5>
###### 這是一個(gè) <h6>

<!-- 對于 <h1> 和 <h2> 元素，Markdown 額外提供了兩種添加方式。 -->
這是一個(gè) h1
=============

這是一個(gè) h2
-------------

<!-- 簡易文本樣式 -->
<!-- 文本的斜體，粗體，和刪除線在 Markdown 中可以輕易地被實(shí)現(xiàn)。-->

*此文本為斜體。*
_此文本也是。_

**此文本為粗體。**
__此文本也是__

***此文本是斜體加粗體。***
**_或者這樣。_**
*__這個(gè)也是！__*

<!-- 在 Github 采用的 Markdown 中 -->

~~此文本為刪除線效果。~~

<!-- 單個(gè)段落由一句或多句鄰近的句子組成，這些句子由一個(gè)或多個(gè)空格分隔。-->

這是第一段落. 這句話在同一個(gè)段落里，好玩么？

現(xiàn)在我是第二段落。
這句話也在第二段落！

這句話在第三段落！

<!-- 如果你插入一個(gè) HTML中的<br />標(biāo)簽，你可以在段末加入兩個(gè)以上的空格，
然后另起一段。-->

此段落結(jié)尾有兩個(gè)空格（選中以顯示）。      

上文有一個(gè) <br /> ！

<!-- 段落引用可由 > 字符輕松實(shí)現(xiàn)。-->

> 這是一個(gè)段落引用. 你可以
> 手動(dòng)斷開你的句子，然后在每句句子前面添加 “>” 字符。或者讓你的句子變得很長，以至于他們自動(dòng)得斷開。
> 只要你的文字以“>” 字符開頭，兩種方式無異。

> 你也對文本進(jìn)行
>> 多層引用
> 這多機(jī)智??！

<!-- 序列 -->
<!-- 無序序列可由星號，加號或者減號來建立 -->

* 項(xiàng)目
* 項(xiàng)目
* 另一個(gè)項(xiàng)目

或者

+ 項(xiàng)目
+ 項(xiàng)目
+ 另一個(gè)項(xiàng)目

或者 

- 項(xiàng)目
- 項(xiàng)目
- 最后一個(gè)項(xiàng)目

<!-- 有序序列可由數(shù)字加點(diǎn)來實(shí)現(xiàn) -->

1. 項(xiàng)目一
2. 項(xiàng)目二
3. 項(xiàng)目三

<!-- 即使你的標(biāo)簽數(shù)字有誤，Markdown 依舊會(huì)呈現(xiàn)出正確的序號，
不過這并不是一個(gè)好主意-->

1. 項(xiàng)目一
1. 項(xiàng)目二
1. 項(xiàng)目三
<!-- (此段與前例一模一樣) -->

<!-- 你也可以使用子序列 -->

1. 項(xiàng)目一
2. 項(xiàng)目二
3. 項(xiàng)目三
    * 子項(xiàng)目
    * 子項(xiàng)目
4. 項(xiàng)目四

<!-- 代碼段落 -->
<!-- 代碼段落（HTML中 <code>標(biāo)簽）可以由縮進(jìn)四格（spaces）
或者一個(gè)制表符（tab）實(shí)現(xiàn)-->

    This is code
    So is this

<!-- 在你的代碼中，你仍然使用tab可以進(jìn)行縮進(jìn)操作 -->

    my_array.each do |item|
        puts item
    end

<!-- 內(nèi)聯(lián)代碼可由反引號 ` 實(shí)現(xiàn) -->

John 甚至不知道 `go_to()` 方程是干嘛的!

<!-- 在Github的 Markdown中，對于代碼你可以使用特殊的語法 -->

\`\`\`ruby <!-- 插入時(shí)記得移除反斜線， 僅留```ruby ！ -->
def foobar
    puts "Hello world!"
end
\`\`\` <!-- 這里也是，移除反斜線，僅留 ``` -->

<!-- 以上代碼不需要縮進(jìn)，而且 Github 會(huì)根據(jù)```后表明的語言來進(jìn)行語法高亮 -->

<!-- 水平線 （<hr />） -->
<!-- 水平線可由三個(gè)或以上的星號或者減號創(chuàng)建，可帶可不帶空格。 -->

***
---
- - - 
****************

<!-- 鏈接 -->
<!-- Markdown 最棒的地方就是簡易的鏈接制作。鏈接文字放在中括號[]內(nèi)，
在隨后的括弧()內(nèi)加入url。-->

[點(diǎn)我點(diǎn)我!](http://test.com/)

<!-- 你也可以為鏈接加入一個(gè)標(biāo)題：在括弧內(nèi)使用引號 -->

[點(diǎn)我點(diǎn)我!](http://test.com/ "連接到Test.com")

<!-- 相對路徑也可以有 -->

[去 music](/music/).

<!-- Markdown同樣支持引用樣式的鏈接 -->

[點(diǎn)此鏈接][link1]以獲取更多信息！
[看一看這個(gè)鏈接][foobar] 如果你愿意的話.

<!-- 鏈接的標(biāo)題可以處于單引號中，括弧中或是被忽略。引用名可以在文檔的任意何處，
并且可以隨意命名，只要名稱不重復(fù)。-->

<!-- “隱含式命名” 的功能可以讓鏈接文字作為引用名 -->

[This][] is a link.

<!-- 但這并不常用 -->

<!-- 圖像 -->
<!-- 圖像與鏈接相似，只需在前添加一個(gè)感嘆號 -->

![這是我圖像的懸停文本(alt text)](http://imgur.com/myimage.jpg "可選命名")

<!-- 引用樣式也同樣起作用 -->

![這是我的懸停文本.][myimage]

<!-- 雜項(xiàng) -->
<!-- 自動(dòng)鏈接 -->

<http://testwebsite.com/> 與
[http://testwebsite.com/](http://testwebsite.com/) 等同

<!-- 電子郵件的自動(dòng)鏈接 -->

<foo@bar.com>

<!-- 轉(zhuǎn)義字符 -->

我希望 *將這段文字置于星號之間* 但是我不希望它被
斜體化, 所以我就: \*這段置文字于星號之間\*。

<!-- 表格 -->
<!-- 表格只被 Github 的 Markdown 支持，并且有一點(diǎn)笨重，但如果你真的要用的話: -->

| 第一列        | 第二列    | 第三列       |
| :----------   | :------:  | ----------:  |
| 左對齊        | 居個(gè)中    | 右對齊       |
| 某某某        | 某某某    | 某某某       |

<!-- 或者, 同樣的 -->

第一列 | 第二列 | 第三列
:-- | :-: | --:
這太丑了 | 藥不能 | 停

<!-- 結(jié)束! -->

更多信息, 請于此處參見 John Gruber 關(guān)于語法的官方帖子，及于此處?參見 Adam Pritchard 的摘要筆記。