聲明: 這份文檔派生(fork)于繁體中文版,在此基礎(chǔ)上進行了繁體轉(zhuǎn)簡體工作,并進行了適當?shù)臐櫳?。此文檔用 Markdown 語法編寫,你可以到這里查看它的源文件?!阜斌w中文版的原始文件可以查看這里」--By @riku
注: 本項目托管于 此頁提供了 Markdown 的簡單概念, 語法說明 頁提供了完整詳細的文檔,說明了每項功能。但是 Markdown 其實很簡單就可以上手,此頁文檔提供了一些范例,并且每個范例都會提供輸出的 HTML 結(jié)果。 其實直接試試看也是一個很不錯的方法, Dingus 是一個網(wǎng)頁應(yīng)用程序,你可以把自已編寫的 Markdown 文檔轉(zhuǎn)成 XHTML。 一個段落是由一個以上的連接的行句組成,而一個以上的空行則會劃分出不同的段落(空行的定義是顯示上看起來像是空行,就被視為空行,例如有一行只有空白和 tab,那該行也會被視為空行),一般的段落不需要用空白或換行縮進。 Markdown 支持兩種標題的語法,Setext 和 atx 形式。Setext 形式是用底線的形式,利用 區(qū)塊引用則使用 email 形式的 ' Markdown 語法: 輸出 HTML 為: Now is the time for all good men to come tothe aid of their country. This is just aregular paragraph. The quick brown fox jumped over the lazydog's back. This is a blockquote. This is the second paragraph in the blockquote. Markdown 使用星號和底線來標記需要強調(diào)的區(qū)段。 Markdown 語法: 輸出 HTML 為: Some of these words are emphasized.Some of these words are emphasized also. Use two asterisks for strong emphasis.Or, if you prefer, use two underscores instead. 無序列表使用星號、加號和減號來做為列表的項目標記,這些符號是都可以使用的,使用星號: 加號: 和減號 都會輸出 HTML 為: 有序的列表則是使用一般的數(shù)字接著一個英文句點作為項目標記: 輸出 HTML 為: 如果你在項目之間插入空行,那項目的內(nèi)容會用 輸出 HTML 為: A list item. With multiple paragraphs. Another item in the list. Markdown 支援兩種形式的鏈接語法: 行內(nèi) 和 參考 兩種形式,兩種都是使用角括號來把文字轉(zhuǎn)成連結(jié)。 行內(nèi)形式是直接在后面用括號直接接上鏈接: 輸出 HTML 為: This is an example link. 你也可以選擇性的加上 title 屬性: 輸出 HTML 為: This is an example link. 參考形式的鏈接讓你可以為鏈接定一個名稱,之后你可以在文件的其他地方定義該鏈接的內(nèi)容: 輸出 HTML 為: title 屬性是選擇性的,鏈接名稱可以用字母、數(shù)字和空格,但是不分大小寫: 輸出 HTML 為: I start my morning with a cup of coffee andThe New York Times. 圖片的語法和鏈接很像。 行內(nèi)形式(title 是選擇性的): 參考形式: 上面兩種方法都會輸出 HTML 為: 在一般的段落文字中,你可以使用反引號 輸出 HTML 為: I strongly recommend against using any I wish SmartyPants used named entities like 如果要建立一個已經(jīng)格式化好的代碼區(qū)塊,只要每行都縮進 4 個空格或是一個 tab 就可以了,而 Markdown 語法: For example. 輸出 HTML 為: If you want your page to validate under XHTML 1.0 Strict,you've got to put paragraph tags in your blockquotes: For example.Markdown: Basics (快速入門) / (點擊查看完整語法說明)
Getting the Gist of Markdown's Formatting Syntax
段落、標題、區(qū)塊代碼
=
(最高階標題)和 -
(第二階標題),Atx 形式在行首插入 1 到 6 個 #
,對應(yīng)到標題 1 到 6 階。>
' 角括號。A First Level Header====================A Second Level Header---------------------Now is the time for all good men to come tothe aid of their country. This is just aregular paragraph.The quick brown fox jumped over the lazydog's back.### Header 3> This is a blockquote.> > This is the second paragraph in the blockquote.>> ## This is an H2 in a blockquote
A First Level Header
A Second Level Header
Header 3
This is an H2 in a blockquote
修辭和強調(diào)
Some of these words *are emphasized*.Some of these words _are emphasized also_.Use two asterisks for **strong emphasis**.Or, if you prefer, __use two underscores instead__.
列表
* Candy.* Gum.* Booze.
+ Candy.+ Gum.+ Booze.
- Candy.- Gum.- Booze.
1. Red2. Green3. Blue
包起來,你也可以在一個項目內(nèi)放上多個段落,只要在它前面縮排 4 個空白或 1 個 tab 。
* A list item. With multiple paragraphs.* Another item in the list.
鏈接
This is an [example link](http://example.com/).
This is an [example link](http://example.com/ 'With a Title').
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 start my morning with a cup of coffee and[The New York Times][NY Times].[ny times]: http://www.nytimes.com/
圖片
![alt text](/path/to/img.jpg 'Title')
![alt text][id][id]: /path/to/img.jpg 'Title'
代碼
`
來標記代碼區(qū)段,區(qū)段內(nèi)的 &
、 和
>
都會被自動的轉(zhuǎn)換成 HTML 實體,這項特性讓你可以很容易的在代碼區(qū)段內(nèi)插入 HTML 碼:I strongly recommend against using any `
tags.
—
instead of decimal-encodedentites like —
.&
、 和
>
也一樣會自動轉(zhuǎn)成 HTML 實體。If you want your page to validate under XHTML 1.0 Strict,you've got to put paragraph tags in your blockquotes:
聯(lián)系客服