原文地址:LoveDev
Markdown:一種簡單易學功能強大、任何文本編輯器都可以編寫的標記語言。目前 github、Stackoverflow 等網站都支持這種格式。
標題
Markdown 支持兩種標題的語法,類 Setext 和類 atx 形式。
類 Setext 形式是用底線的形式,利用 = (最高階標題)和 - (第二階標題),例如:
This is an H1
=============
This is an H2
-------------
任何數(shù)量的 = 和 - 都可以有效果,要寫在文章的最開頭才會有效果。
類 Atx 形式則是在行首插入 1 到 6 個 # ,對應到標題 1 到 6 階,例如:
# 這是 H1
## 這是 H2
###### 這是 H6
區(qū)塊引用
引用別人文字的時候,這個格式就顯得非常必要。Markdown 標記區(qū)塊引用是使用類似 email 中用 > 的引用方式。
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
>
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.
Markdown 也允許你偷懶只在整個段落的第一行最前面加上 > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
區(qū)塊引用可以嵌套(例如:引用內的引用),只要根據層次加上不同數(shù)量的 > :
This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.
引用的區(qū)塊內也可以使用其他的 Markdown 語法,包括標題、列表、代碼區(qū)塊等:
> ## 這是一個標題。
>
> 1. 這是第一行列表項。
> 2. 這是第二行列表項。
>
> 給出一些例子代碼:
>
> return shell_exec("echo $input | $markdown_script");
注:>和文本之間要保留一個字符的空格。
列表
Markdown 支持有序列表和無序列表。
無序列表可以使用星號、加號或是減號作為列表標記:
* Red
* Green
* Blue
+ Red
+ Green
+ Blue
- Red
- Green
- Blue
注:上面的三種格式效果都相同,符號后面保留一個字符的空格。
有序列表則使用數(shù)字接著一個英文句點:
1. Bird
2. McHale
3. Parish
分割線
可以在一行中用三個以上的星號、減號、底線來建立一個分隔線,行內不能有其他東西。
***
************
---
------------
鏈接
Markdown 支持兩種形式的鏈接語法: 行內式和參考式兩種形式,不管是哪一種,鏈接文字都是用 [方括號] 來標記。
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
隱式鏈接標記功能讓你可以省略指定鏈接標記,這種情形下,鏈接標記會視為等同于鏈接文字,要用隱式鏈接標記,只需要在鏈接文字后面加上一個空的方括號:
[Google][]
定義鏈接內容:
[Google]: http://google.com/
注:鏈接的定義可以放在文件中的任何一個地方,最好放到文件最后集中管理。
參考式鏈接的范例:
[Google] [1]
[Baidu] [2]
[LoveDev] [3]
[1]: http://google.com/ "Google Search"
[2]: http://baidu.com/ "Baidu Search"
[3]: http://lovedev.org/ "My Blog "
參考式的鏈接其實重點不在于它比較好寫,而是它比較好讀以及易于維護,文章內容不需要改變,只用改變標示對應的鏈接就可以了。
強調
Markdown 使用星號(*)和底線(_)作為標記強調字詞的符號,被 * 或 _ 包圍的字詞會被轉成用 <em> 標簽包圍,用兩個 * 或 _ 包起來的話,則會被轉成 <strong>。
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
會轉成:
<em>single asterisks</em>
<em>single underscores</em>
<strong>double asterisks</strong>
<strong>double underscores</strong>
注:唯一的限制是,用什么符號開啟標簽,就要用什么符號結束。
代碼
如果要標記一小段行內代碼,你可以用反引號把它包起來(`)。
Use the `printf()` function.
如果要在代碼區(qū)段內插入反引號,你可以用多個反引號來開啟和結束代碼區(qū)段:
``There is a literal backtick (`) here.``
圖片
Markdown 使用一種和鏈接很相似的語法來標記圖片,同樣也允許兩種樣式: 行內式和參考式。
行內式的圖片語法:


詳細敘述如下:
- 一個驚嘆號 !
- 接著一個方括號,里面放上圖片的替代文字
- 接著一個普通括號,里面放上圖片的網址,最后還可以用引號包住并加上 選擇性的 'title' 文字。
參考式的圖片語法:
![Alt text][id]
「id」是圖片參考的名稱,圖片參考的定義方式和參考式鏈接一樣:
[id]: url/to/image "Optional title attribute"
反斜杠
Markdown 可以利用反斜杠來插入一些在語法中有其它意義的符號。
\*literal asterisks\*
Markdown 支持以下符號前面加上反斜杠來幫助插入普通的符號:
\ 反斜線
` 反引號
* 星號
_ 底線
{} 花括號
[] 方括號
() 括弧
# 井字號
+ 加號
- 減號
. 英文句點
! 驚嘆號
自動鏈接
Markdown 支持以比較簡短的自動鏈接形式來處理網址和電子郵件信箱,只要是用方括號包起來, Markdown 就會自動把它轉成鏈接。例如:
<http://example.com/>
Markdown 會轉為:
<a >http://example.com/</a>
郵址的自動鏈接也很類似,只是 Markdown 會先做一個編碼轉換的過程,把文字字符轉成 16 進位碼的 HTML 實體,這樣的格式可以糊弄一些不好的郵址收集機器人,例如:
<616651408@qq.com>
Markdown 會轉成:
<a href="mailto:addre
ss@example.co
m">address@exa
mple.com</a>