|
|
@ -55,7 +55,7 @@ Markdown 將容易閱讀和容易寫作這兩點作為主要目標。 |
|
|
|
|
|
|
|
|
|
|
|
為了這個目的,Markdown 的語法全部由標點符號來組成,標點符號的選擇是依 |
|
|
|
為了這個目的,Markdown 的語法全部由標點符號來組成,標點符號的選擇是依 |
|
|
|
據他們看起來樣子或是他們的意義慎重的考慮的,像是在文字兩旁加上星號,看 |
|
|
|
據他們看起來樣子或是他們的意義慎重的考慮的,像是在文字兩旁加上星號,看 |
|
|
|
起來就很像在 \*強調\* 。Markdow 的清單就很像是清單,區塊引研究很像是電 |
|
|
|
起來就很像在 \*強調\* 。Markdow 的清單就很像是清單,區塊引言就很像是電 |
|
|
|
子郵件的引言。 |
|
|
|
子郵件的引言。 |
|
|
|
|
|
|
|
|
|
|
|
<h3 id="html">行內 HTML</h3> |
|
|
|
<h3 id="html">行內 HTML</h3> |
|
|
@ -63,8 +63,8 @@ Markdown 將容易閱讀和容易寫作這兩點作為主要目標。 |
|
|
|
Markdown 的語法有個主要的目的:用來作為一種網路內容的 *寫作* 用語言。 |
|
|
|
Markdown 的語法有個主要的目的:用來作為一種網路內容的 *寫作* 用語言。 |
|
|
|
|
|
|
|
|
|
|
|
Markdown 不是要來取代 HTML,甚至也沒有要和它相似,它的語法種類不多, |
|
|
|
Markdown 不是要來取代 HTML,甚至也沒有要和它相似,它的語法種類不多, |
|
|
|
只和 HTML 的一部分有關係,重點 *不是* 要創造一種更容易插入 HTML 標籤 |
|
|
|
只和 HTML 的一部分有關係,重點 *不是* 要創造一種更容易寫作 HTML 文件 |
|
|
|
的語法,我認為 HTML 已經很容易插入了,Markdown 的重點在讓文件更容易 |
|
|
|
的語法,我認為 HTML 已經很容易寫了,Markdown 的重點在讓文件更容易 |
|
|
|
閱讀、編寫,HTML 是一種 *發佈* 的格式,Markdown 是一種 *編寫* 的格式, |
|
|
|
閱讀、編寫,HTML 是一種 *發佈* 的格式,Markdown 是一種 *編寫* 的格式, |
|
|
|
因此,Markdown 的格式語法只涵蓋純文字可以涵蓋的範圍。 |
|
|
|
因此,Markdown 的格式語法只涵蓋純文字可以涵蓋的範圍。 |
|
|
|
|
|
|
|
|
|
|
@ -91,13 +91,13 @@ Markdown 不是要來取代 HTML,甚至也沒有要和它相似,它的語法 |
|
|
|
請注意,在 HTML 區塊標籤內,是不會對 Markdown 的語法進行處理的。例如, |
|
|
|
請注意,在 HTML 區塊標籤內,是不會對 Markdown 的語法進行處理的。例如, |
|
|
|
HTML 區塊內,無法使用 Markdown 形式的 `*強調*` |
|
|
|
HTML 區塊內,無法使用 Markdown 形式的 `*強調*` |
|
|
|
|
|
|
|
|
|
|
|
HTML 的跨度標間如 `<span>`, `<cite>` 或者 `<del>` 則不受限制,可以在 |
|
|
|
HTML 的區段標間如 `<span>`, `<cite>` 或者 `<del>` 則不受限制,可以在 |
|
|
|
Markdown 的段落、清單或是檔頭裡任意使用。依照個人習慣,甚至可以不用 |
|
|
|
Markdown 的段落、清單或是標題裡任意使用。依照個人習慣,甚至可以不用 |
|
|
|
Markdown 格式,而採用 HTML 標籤來格式化。舉例說明:如果比較喜歡 HTML |
|
|
|
Markdown 格式,而採用 HTML 標籤來格式化。舉例說明:如果比較喜歡 HTML |
|
|
|
的 `<a>` 或 `<img>` 標籤,可以直接使用這些標籤,而不用 Markdown 提 |
|
|
|
的 `<a>` 或 `<img>` 標籤,可以直接使用這些標籤,而不用 Markdown 提 |
|
|
|
供的連結或是影像標示語法。 |
|
|
|
供的連結或是影像標示語法。 |
|
|
|
|
|
|
|
|
|
|
|
HTML 跨度標籤和區塊標籤不同,在跨度標籤的範圍內, Markdown 的語法是有效的。 |
|
|
|
HTML 區段標籤和區塊標籤不同,在區段標籤的範圍內, Markdown 的語法是有效的。 |
|
|
|
|
|
|
|
|
|
|
|
<h3 id="autoescape">特殊字元自動轉換</h3> |
|
|
|
<h3 id="autoescape">特殊字元自動轉換</h3> |
|
|
|
|
|
|
|
|
|
|
@ -106,7 +106,7 @@ HTML 跨度標籤和區塊標籤不同,在跨度標籤的範圍內, Markdown |
|
|
|
使用實體的形式,像是 `<` 和 `&`。 |
|
|
|
使用實體的形式,像是 `<` 和 `&`。 |
|
|
|
|
|
|
|
|
|
|
|
`&` 符號其實很讓寫作網路文件的人很困擾,如果你要打 'AT&T' ,你必須要寫成 |
|
|
|
`&` 符號其實很讓寫作網路文件的人很困擾,如果你要打 'AT&T' ,你必須要寫成 |
|
|
|
'`AAT&T`' ,你還必須要轉換網址內的 `&` 符號,如果你要連結到: |
|
|
|
'`AT&T`' ,你還必須要轉換網址內的 `&` 符號,如果你要連結到: |
|
|
|
|
|
|
|
|
|
|
|
http://images.google.com/images?num=30&q=larry+bird |
|
|
|
http://images.google.com/images?num=30&q=larry+bird |
|
|
|
|
|
|
|
|
|
|
@ -114,8 +114,8 @@ HTML 跨度標籤和區塊標籤不同,在跨度標籤的範圍內, Markdown |
|
|
|
|
|
|
|
|
|
|
|
http://images.google.com/images?num=30&q=larry+bird |
|
|
|
http://images.google.com/images?num=30&q=larry+bird |
|
|
|
|
|
|
|
|
|
|
|
才能放到你的連結標籤的 `href` 裡,不用說,這很容易忘記,可能是最大的 |
|
|
|
才能放到你的連結標籤的 `href` 裡,不用說也知道這很容易忘記,這也可能是數量最多的 |
|
|
|
HTML 標準檢查的錯誤來源。 |
|
|
|
HTML 標準檢查的錯誤。 |
|
|
|
|
|
|
|
|
|
|
|
Markdown 允許你直接使用這些符號,但是你要小心跳脫字元的使用,如果你是在 |
|
|
|
Markdown 允許你直接使用這些符號,但是你要小心跳脫字元的使用,如果你是在 |
|
|
|
HTML 實體中使用 `&` 符號的話,它不會被轉換,而在其它情形下,它則會被轉換 |
|
|
|
HTML 實體中使用 `&` 符號的話,它不會被轉換,而在其它情形下,它則會被轉換 |
|
|
@ -133,7 +133,7 @@ Markdown 就會將它轉為: |
|
|
|
|
|
|
|
|
|
|
|
AT&T |
|
|
|
AT&T |
|
|
|
|
|
|
|
|
|
|
|
類似的狀況也會發生在 `<` 符號上,因為 Markdown 支援 [inline HTML](#html) , |
|
|
|
類似的狀況也會發生在 `<` 符號上,因為 Markdown 支援 [行內 HTML](#html) , |
|
|
|
如果你是使用 `<` 符號作為 HTML 標籤使用,那 Markdown 也不會對它做任何轉換, |
|
|
|
如果你是使用 `<` 符號作為 HTML 標籤使用,那 Markdown 也不會對它做任何轉換, |
|
|
|
但是如果你是寫: |
|
|
|
但是如果你是寫: |
|
|
|
|
|
|
|
|
|
|
@ -146,7 +146,7 @@ Markdown 將會把它轉換為: |
|
|
|
不過要注意的是,code 範圍內,不論是行內還是區塊, `<` 和 `&` 兩個符號都 *一定* |
|
|
|
不過要注意的是,code 範圍內,不論是行內還是區塊, `<` 和 `&` 兩個符號都 *一定* |
|
|
|
會被轉換成 HTML 實體,這項特性讓你可以很容易的用 Markdown 寫 HTML code |
|
|
|
會被轉換成 HTML 實體,這項特性讓你可以很容易的用 Markdown 寫 HTML code |
|
|
|
(和 HTML 相對而言, HTML 語法中,你要把所有的 `<` 和 `&` 都轉換為 HTML 實體, |
|
|
|
(和 HTML 相對而言, HTML 語法中,你要把所有的 `<` 和 `&` 都轉換為 HTML 實體, |
|
|
|
你才能再 HTML 文件裡面寫出 HTML code) |
|
|
|
你才能在 HTML 文件裡面寫出 HTML code) |
|
|
|
|
|
|
|
|
|
|
|
* * * |
|
|
|
* * * |
|
|
|
|
|
|
|
|
|
|
@ -155,11 +155,11 @@ Markdown 將會把它轉換為: |
|
|
|
|
|
|
|
|
|
|
|
<h3 id="p">段落和換行</h3> |
|
|
|
<h3 id="p">段落和換行</h3> |
|
|
|
|
|
|
|
|
|
|
|
一個段落是由一個以上的連接的行句組成,而一個以上的空行則會切分出不同的段落 |
|
|
|
一個段落是由一個以上連接的行句組成,而一個以上的空行則會切分出不同的段落 |
|
|
|
(空行的定義是顯示上看起來像是空行,就被視為空行,例如有一行只有空白和 tab, |
|
|
|
(空行的定義是顯示上看起來像是空行,就被視為空行,例如有一行只有空白和 tab, |
|
|
|
那該行也會被視為空行),一般的段落不需要用空白或斷行縮排。 |
|
|
|
那該行也會被視為空行),一般的段落不需要用空白或斷行縮排。 |
|
|
|
|
|
|
|
|
|
|
|
「一個或以上的連接的行句組成」這句其實暗示了 Markdow 允許段落內的強迫斷行, |
|
|
|
「一個以上連接的行句組成」這句其實暗示了 Markdow 允許段落內的強迫斷行, |
|
|
|
這個特性和其他大部分的 text-to-HTML 格式不一樣(包括 MovableType 的 |
|
|
|
這個特性和其他大部分的 text-to-HTML 格式不一樣(包括 MovableType 的 |
|
|
|
"Convert Line Breaks" 選項),其它的格式會把每個斷行都轉成 `<br />` 標籤。 |
|
|
|
"Convert Line Breaks" 選項),其它的格式會把每個斷行都轉成 `<br />` 標籤。 |
|
|
|
|
|
|
|
|
|
|
@ -167,7 +167,7 @@ Markdown 將會把它轉換為: |
|
|
|
|
|
|
|
|
|
|
|
是的,這確實讓你要花比較多功夫插入 `<br />` ,但是「每個換行都轉換為 `<br />`」 |
|
|
|
是的,這確實讓你要花比較多功夫插入 `<br />` ,但是「每個換行都轉換為 `<br />`」 |
|
|
|
的方法在 Markdown 中並不適合, Markdown 的 email 式的 [區塊引言][bq] 和多段落的 |
|
|
|
的方法在 Markdown 中並不適合, Markdown 的 email 式的 [區塊引言][bq] 和多段落的 |
|
|
|
[清單][l] 在使用換行來排版的時候,不但更好用,還更好看! |
|
|
|
[清單][l] 在使用換行來排版的時候,不但更好用,還更好閱讀! |
|
|
|
|
|
|
|
|
|
|
|
[bq]: #blockquote |
|
|
|
[bq]: #blockquote |
|
|
|
[l]: #list |
|
|
|
[l]: #list |
|
|
@ -187,7 +187,7 @@ Setext 形式是用底線的形式,利用 `=` (最高階標題)和 `-` ( |
|
|
|
|
|
|
|
|
|
|
|
任何數量的 `=` 和 `-` 都可以有效果。 |
|
|
|
任何數量的 `=` 和 `-` 都可以有效果。 |
|
|
|
|
|
|
|
|
|
|
|
Atx 形式在行首插入 1 到 6 個 `#` ,對應到標題 1 到 6 階,例如: |
|
|
|
Atx 形式則是在行首插入 1 到 6 個 `#` ,對應到標題 1 到 6 階,例如: |
|
|
|
|
|
|
|
|
|
|
|
# This is an H1 |
|
|
|
# This is an H1 |
|
|
|
|
|
|
|
|
|
|
@ -267,7 +267,7 @@ Markdown 支援有序清單和無序清單。 |
|
|
|
+ Green |
|
|
|
+ Green |
|
|
|
+ Blue |
|
|
|
+ Blue |
|
|
|
|
|
|
|
|
|
|
|
和: |
|
|
|
也等同於: |
|
|
|
|
|
|
|
|
|
|
|
- Red |
|
|
|
- Red |
|
|
|
- Green |
|
|
|
- Green |
|
|
@ -642,7 +642,7 @@ Markdown 使用星號 (`*`) 和底線 (`_`) 作為標記強調字詞的符號, |
|
|
|
|
|
|
|
|
|
|
|
un*frigging*believable |
|
|
|
un*frigging*believable |
|
|
|
|
|
|
|
|
|
|
|
但日如果你的 `*` 和 `_` 兩邊都有空白的話,它們就只會被當成普通的符號。 |
|
|
|
但是如果你的 `*` 和 `_` 兩邊都有空白的話,它們就只會被當成普通的符號。 |
|
|
|
|
|
|
|
|
|
|
|
如果要在文字前後直接插入普通的星號或底線,你可以用反斜線: |
|
|
|
如果要在文字前後直接插入普通的星號或底線,你可以用反斜線: |
|
|
|
|
|
|
|
|
|
|
@ -760,7 +760,7 @@ Markdown 會轉成: |
|
|
|
|
|
|
|
|
|
|
|
在瀏覽器裡面,這段字串會變成一個可以點擊的 "address@example.com" 連結。 |
|
|
|
在瀏覽器裡面,這段字串會變成一個可以點擊的 "address@example.com" 連結。 |
|
|
|
|
|
|
|
|
|
|
|
(這種作法雖然可以混淆不少的機器人,但並不是全部,不過這樣也比什麼都不做還好 |
|
|
|
(這種作法雖然可以混淆不少的機器人,但並無法全部檔下來,不過這樣也比什麼都不做還好 |
|
|
|
不管如何,公開你的信箱終究是會引來廣告信件的。) |
|
|
|
不管如何,公開你的信箱終究是會引來廣告信件的。) |
|
|
|
|
|
|
|
|
|
|
|
<h3 id="backslash">跳脫字元</h3> |
|
|
|
<h3 id="backslash">跳脫字元</h3> |
|
|
|