標題語法
H1
H2
H3
H4
H5
H6
區塊引用 Blockquotes
這里是一個區塊
blockquotes區塊跳行 ...
class HelloWorld {
public static void main (String[] args){
System.out.println("");
}
} //只要再最后一行加上‘>’也行引用的嵌套
這是一個標題。
- 這是第一行列表項。
- 這是第二行列表項。
給出一些例子代碼:
return shell_exec("echo $input | $markdown_script");
列表
Markdown 支持有序列表和無序列表。
無序列表使用星號、加號或是減號作為列表標記:
- Red
- Green
- Blue
等同于:
- Red
- Green
- Blue
也等同于:
- Red
- Green
- Blue
有序列表則使用數字接著一個英文句點:
- Bird
- McHale
- Parish
列表項目標記通常是放在最左邊,但是其實也可以縮進,最多 3 個空格,項目標記后面則一定要接著至少一個空格或制表符。
要讓列表看起來更漂亮,你可以把內容用固定的縮進整理好:
- 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.
如果要在列表項目內放進引用,那 >
就需要縮進:
- A list item with a blockquote: > This is a blockquote > inside a list item.
如果要放代碼區塊的話,該區塊就需要縮進兩次,也就是 8 個空格或是 2 個制表符:
- 一列表項包含一個列表區塊: <代碼寫在這>
當然,項目列表很可能會不小心產生,像是下面這樣的寫法:
- What a great season.
換句話說,也就是在行首出現數字-句點-空白,要避免這樣的狀況,你可以在句點前面加上反斜杠。
1986. What a great season.
代碼區塊
<pre><code>NSLog("%@",NSString stringWithFormat:@"HelloWorld")</code></pre>
分割線
你可以在一行中用三個以上的星號、減號、底線來建立一個分隔線,行內不能有其他東西。你也可以在星號或是減號中間插入空格。下面每種寫法都可以建立分隔線:
區段元素
鏈接
Markdown 支持兩種形式的鏈接語法: 行內式 和 參考式 兩種形式。
不管是哪一種,鏈接文字都是用 [方括號] 來標記。
要建立一個行內式的鏈接,只要在方塊括號后面緊接著圓括號并插入網址鏈接即可,如果你還想要加上鏈接的 title 文字,只要在網址后面,用雙引號把 title 文字包起來即可,例如:
<blockquote>
This is an example inline link.This link has no title attribute.
</blockquote>
會產生:
<blockquote>
<p>This is <a title="Title">
an example</a> inline link.</p>
<p><a >This link</a> has no
title attribute.</p>
</blockquote>
如果你是要鏈接到同樣主機的資源,你可以使用相對路徑:
<blockquote>
See my About page for details.
</blockquote>
參考式的鏈接是在鏈接文字的括號后面再接上另一個方括號,而在第二個方括號里面要填入用以辨識鏈接的標記:
<blockquote>
This is [an example][id] reference-style link.
</blockquote>
你也可以選擇性地在兩個方括號中間加上一個空格:
<blockquote>
This is [an example] [id] reference-style link.
</blockquote>
接著,在文件的任意處,你可以把這個標記的鏈接內容定義出來:
<blockquote>
[id]: http://example.com/ "Optional Title Here"
</blockquote>
強調
Markdown 使用星號()和底線()作為標記強調字詞的符號,被 *或 _ 包圍的字詞會被轉成用 <em>標簽包圍,用兩個 *或包起來的話,則會被轉成 <strong>,例如:
single asteriskssingle underscoresdouble asterisks*double underscores
會轉成:
<em>single asterisks</em><em>single underscores</em><strong>double asterisks</strong><strong>double underscores</strong>
你可以隨便用你喜歡的樣式,唯一的限制是,你用什么符號開啟標簽,就要用什么符號結束。
強調也可以直接插在文字中間:
unfriggingbelievable
但是*如果你的 和 _兩邊都有空白的話,它們就只會被當成普通的符號。
如果要在文字前后直接插入普通的星號或底線,你可以用反斜線:
*this text is surrounded by literal asterisks*
代碼
如果要標記一小段行內代碼,你可以用反引號把它包起來(`),例如:
Use the printf()
function.
圖片
很明顯地,要在純文字應用中設計一個「自然」的語法來插入圖片是有一定難度的。
Markdown 使用一種和鏈接很相似的語法來標記圖片,同樣也允許兩種樣式: 行內式和參考式。
行內式的圖片語法看起來像是:


詳細敘述如下:
一個驚嘆號 !
接著一個方括號,里面放上圖片的替代文字
接著一個普通括號,里面放上圖片的網址,最后還可以用引號包住并加上 選擇性的 'title' 文字。
參考式的圖片語法則長得像這樣:
![Alt text][id]
「id」是圖片參考的名稱,圖片參考的定義方式則和連結參考一樣:
[id]: url/to/image "Optional title attribute"
到目前為止, Markdown 還沒有辦法指定圖片的寬高,如果你需要的話,你可以使用普通的 <img>
標簽。
如果實在看暈了 : 看一下wiki上的這個對比圖就知道了
(https://en.wikipedia.org/wiki/Markdown#Example)
給個github follow me的鏈接,上面有很多初學者可供學習的資料,項目.
<a>https://github.com/SuperZee</a>