|
|
|
@ -49,11 +49,11 @@ Markdown 的目標是實現「易讀易寫」。
@@ -49,11 +49,11 @@ Markdown 的目標是實現「易讀易寫」。
|
|
|
|
|
[5]: http://www.triptico.com/software/grutatxt.html |
|
|
|
|
[6]: http://ettext.taint.org/doc/ |
|
|
|
|
|
|
|
|
|
因此 Markdown 的語法完全是由標點符號所組成,並且經過謹慎考慮,為的是看起來就像是它們所要表達的意思。像是在文字兩旁加上星號,看起來就像 \*強調\* 。Markdown 的清單看起來,嗯,就是清單。假如你有使用過電子郵件,區塊引言看起來就真的是引用一段文字。 |
|
|
|
|
因此 Markdown 的語法全由標點符號所組成,並且經過謹慎考慮,為的是讓它們看起來就像所要表達的意思。像是在文字兩旁加上星號,看起來就像\*強調\*。Markdown 的清單看起來,嗯,就是清單。假如你有使用過電子郵件,區塊引言看起來就真的像是引用一段文字。 |
|
|
|
|
|
|
|
|
|
<h3 id="html">行內 HTML</h3> |
|
|
|
|
|
|
|
|
|
Markdown 的語法有個主要的目的:用來作為一種網路內容的 *寫作* 用語言。 |
|
|
|
|
Markdown 的語法有個主要的目的:用來作為一種網路內容的*寫作*用語言。 |
|
|
|
|
|
|
|
|
|
Markdown 不是要來取代 HTML,甚至也沒有要和它相似,它的語法種類不多,只和 HTML 的一部分有關係,重點 *不是* 要創造一種更容易寫作 HTML 文件的語法,我認為 HTML 已經很容易寫了,Markdown 的重點在讓文件更容易閱讀、編寫,HTML 是一種 *發佈* 的格式,Markdown 是一種 *編寫* 的格式,因此,Markdown 的格式語法只涵蓋純文字可以涵蓋的範圍。 |
|
|
|
|
|
|
|
|
@ -75,7 +75,7 @@ Markdown 不是要來取代 HTML,甚至也沒有要和它相似,它的語法
@@ -75,7 +75,7 @@ Markdown 不是要來取代 HTML,甚至也沒有要和它相似,它的語法
|
|
|
|
|
|
|
|
|
|
請注意,在 HTML 區塊標籤內,是不會對 Markdown 的語法進行處理的。例如,HTML 區塊內,無法使用 Markdown 形式的 `*強調*` |
|
|
|
|
|
|
|
|
|
HTML 的區段標間如 `<span>`, `<cite>` 或者 `<del>` 則不受限制,可以在Markdown 的段落、清單或是標題裡任意使用。依照個人習慣,甚至可以不用Markdown 格式,而採用 HTML 標籤來格式化。舉例說明:如果比較喜歡 HTML 的 `<a>` 或 `<img>` 標籤,可以直接使用這些標籤,而不用 Markdown 提供的連結或是影像標示語法。 |
|
|
|
|
HTML 的區段標間如 `<span>`, `<cite>` 或者 `<del>` 則不受限制,可以在 Markdown 的段落、清單或是標題裡任意使用。依照個人習慣,甚至可以不用Markdown 格式,而採用 HTML 標籤來格式化。舉例說明:如果比較喜歡 HTML 的 `<a>` 或 `<img>` 標籤,可以直接使用這些標籤,而不用 Markdown 提供的連結或是影像標示語法。 |
|
|
|
|
|
|
|
|
|
HTML 區段標籤和區塊標籤不同,在區段標籤的範圍內, Markdown 的語法是有效的。 |
|
|
|
|
|
|
|
|
@ -124,7 +124,7 @@ Markdown 將會把它轉換為:
@@ -124,7 +124,7 @@ Markdown 將會把它轉換為:
|
|
|
|
|
|
|
|
|
|
一個段落是由一個以上連接的行句組成,而一個以上的空行則會切分出不同的段落(空行的定義是顯示上看起來像是空行,就被視為空行,例如有一行只有空白和 tab,那該行也會被視為空行),一般的段落不需要用空白或斷行縮排。 |
|
|
|
|
|
|
|
|
|
「一個以上連接的行句組成」這句其實暗示了 Markdow 允許段落內的強迫斷行,這個特性和其他大部分的 text-to-HTML 格式不一樣(包括 MovableType 的 "Convert Line Breaks" 選項),其它的格式會把每個斷行都轉成 `<br />` 標籤。 |
|
|
|
|
「一個以上連接的行句組成」這句其實暗示了 Markdown 允許段落內的強迫斷行,這個特性和其他大部分的 text-to-HTML 格式不一樣(包括 MovableType 的 "Convert Line Breaks" 選項),其它的格式會把每個斷行都轉成 `<br />` 標籤。 |
|
|
|
|
|
|
|
|
|
如果你 *真的* 是想要插入 `<br />` 標籤的話,在行尾加上兩個以上的空白,然後按 enter。 |
|
|
|
|
|
|
|
|
@ -155,7 +155,7 @@ Atx 形式則是在行首插入 1 到 6 個 `#` ,對應到標題 1 到 6 階
@@ -155,7 +155,7 @@ Atx 形式則是在行首插入 1 到 6 個 `#` ,對應到標題 1 到 6 階
|
|
|
|
|
|
|
|
|
|
###### This is an H6 |
|
|
|
|
|
|
|
|
|
你可以選擇性的 "關閉" atx 樣式的標題,這純粹只是美觀用的,你如果覺得這樣看起來比較好,就可以加上 `#` 在行尾,而行尾的 `#` 數量也不用和開頭一樣(行首的數量決定標題的階數): |
|
|
|
|
你可以選擇性地「關閉」atx 樣式的標題,這純粹只是美觀用的,你如果覺得這樣看起來比較好,就可以加上 `#` 在行尾,而行尾的 `#` 數量也不用和開頭一樣(行首的數量決定標題的階數): |
|
|
|
|
|
|
|
|
|
# This is an H1 # |
|
|
|
|
|
|
|
|
@ -253,7 +253,7 @@ Markdown 支援有序清單和無序清單。
@@ -253,7 +253,7 @@ Markdown 支援有序清單和無序清單。
|
|
|
|
|
1. McHale |
|
|
|
|
8. Parish |
|
|
|
|
|
|
|
|
|
你都會得到完全一樣的 HTML 輸出,重點在於,你可以讓你的 Markdown 文件的清單數字和輸出的結果一樣,或是你懶一點,你可以完全不用在意數字的正確性。 |
|
|
|
|
你都會得到完全一樣的 HTML 輸出。重點在於,你可以讓 Markdown 文件的清單數字和輸出的結果相同,或是你懶一點,你可以完全不用在意數字的正確性。 |
|
|
|
|
|
|
|
|
|
如果你使用懶惰的寫法,建議第一個項目最好還是從 1. 開始,因為 Markdown 未來可能會支援有序清單的 start 屬性。 |
|
|
|
|
|
|
|
|
@ -301,7 +301,7 @@ Markdown 支援有序清單和無序清單。
@@ -301,7 +301,7 @@ Markdown 支援有序清單和無序清單。
|
|
|
|
|
<li><p>Magic</p></li> |
|
|
|
|
</ul> |
|
|
|
|
|
|
|
|
|
清單項目可以包含多個段落,每個項目下的端落都必須要縮排 4 個空白或是一個 tab : |
|
|
|
|
清單項目可以包含多個段落,每個項目下的段落都必須縮排 4 個空白或是一個 tab : |
|
|
|
|
|
|
|
|
|
1. This is a list item with two paragraphs. Lorem ipsum dolor |
|
|
|
|
sit amet, consectetuer adipiscing elit. Aliquam hendrerit |
|
|
|
@ -313,7 +313,7 @@ Markdown 支援有序清單和無序清單。
@@ -313,7 +313,7 @@ Markdown 支援有序清單和無序清單。
|
|
|
|
|
|
|
|
|
|
2. Suspendisse id sem consectetuer libero luctus adipiscing. |
|
|
|
|
|
|
|
|
|
如果你每行都有縮排,看起來會看好很多,當然,再次的,如果你很懶惰,Markdown 也允許: |
|
|
|
|
如果你每行都有縮排,看起來會看好很多,當然,再次地,如果你很懶惰,Markdown 也允許: |
|
|
|
|
|
|
|
|
|
* This is a list item with two paragraphs. |
|
|
|
|
|
|
|
|
@ -379,9 +379,9 @@ Markdown 會轉換成:
@@ -379,9 +379,9 @@ Markdown 會轉換成:
|
|
|
|
|
end tell |
|
|
|
|
</code></pre> |
|
|
|
|
|
|
|
|
|
一個程式碼區塊會一直持續到碰到沒有縮排的行(或是文件結尾)。 |
|
|
|
|
一個程式碼區塊會一直持續到碰到沒有縮排的那一行(或是文件結尾)。 |
|
|
|
|
|
|
|
|
|
在程式碼區塊裡面, `&` 、 `<` 和 `>` 會自動轉成 HTML 實體,這樣的方式會讓你非常容易使用 Markdown 插入範例用的 HTML 原始碼,只需要複製貼上,然後縮排就可以了,剩下的 Markdown 都會幫你處理,例如: |
|
|
|
|
在程式碼區塊裡面, `&` 、 `<` 和 `>` 會自動轉成 HTML 實體,這樣的方式讓你非常容易使用 Markdown 插入範例用的 HTML 原始碼,只需要複製貼上,然後縮排就可以了,剩下的 Markdown 都會幫你處理,例如: |
|
|
|
|
|
|
|
|
|
<div class="footer"> |
|
|
|
|
© 2004 Foo Corporation |
|
|
|
@ -479,7 +479,7 @@ Markdown 支援兩種形式的連結語法: *行內* 和 *參考* 兩種形式
@@ -479,7 +479,7 @@ Markdown 支援兩種形式的連結語法: *行內* 和 *參考* 兩種形式
|
|
|
|
|
|
|
|
|
|
網址定義只有在產生連結的時候用到,並不會直接出現在文件之中。 |
|
|
|
|
|
|
|
|
|
連結辨識標籤可以有字母、數字、空白和標點符號,但是並 *不* 分大小寫,因此下面兩個連結是一樣的: |
|
|
|
|
連結辨識標籤可以有字母、數字、空白和標點符號,但是並 *不* 區分大小寫,因此下面兩個連結是一樣的: |
|
|
|
|
|
|
|
|
|
[link text][a] |
|
|
|
|
[link text][A] |
|
|
|
@ -527,7 +527,7 @@ Markdown 支援兩種形式的連結語法: *行內* 和 *參考* 兩種形式
@@ -527,7 +527,7 @@ Markdown 支援兩種形式的連結語法: *行內* 和 *參考* 兩種形式
|
|
|
|
|
<a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a> |
|
|
|
|
or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p> |
|
|
|
|
|
|
|
|
|
下面是用行內形式寫的同樣一段內容的 markdown 文件,提供作為比較之用: |
|
|
|
|
下面是用行內形式寫的同樣一段內容的 Markdown 文件,提供作為比較之用: |
|
|
|
|
|
|
|
|
|
I get 10 times more traffic from [Google](http://google.com/ "Google") |
|
|
|
|
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or |
|
|
|
@ -622,7 +622,7 @@ Markdown 使用星號 (`*`) 和底線 (`_`) 作為標記強調字詞的符號,
@@ -622,7 +622,7 @@ Markdown 使用星號 (`*`) 和底線 (`_`) 作為標記強調字詞的符號,
|
|
|
|
|
|
|
|
|
|
<h3 id="img">圖片</h3> |
|
|
|
|
|
|
|
|
|
很明顯的,要設計一個 "自然" 的語法來在文字中插入圖片是很有難度的。 |
|
|
|
|
很明顯地,要設計一個 「自然」的語法用在文字中插入圖片是很有難度的。 |
|
|
|
|
|
|
|
|
|
Markdown 使用一種和連結很像的語法來標記圖片,同樣也允許兩種樣式: *行內* 和 *參考* 。 |
|
|
|
|
|
|
|
|
@ -663,7 +663,7 @@ Markdown 會轉為:
@@ -663,7 +663,7 @@ Markdown 會轉為:
|
|
|
|
|
|
|
|
|
|
<a href="http://example.com/">http://example.com/</a> |
|
|
|
|
|
|
|
|
|
自動的郵件連結也很類似,只是 Markdown 會先做一個編碼轉換的過程,把文字字元轉成16進位碼的 HTML 實體,這樣的格式可以混淆一些不好的信箱位置收集機器人,例如: |
|
|
|
|
自動的郵件連結也很類似,只是 Markdown 會先做一個編碼轉換的過程,把文字字元轉成16進位碼的 HTML 實體,這樣的格式可以混淆一些不好的信箱地址收集機器人,例如: |
|
|
|
|
|
|
|
|
|
<address@example.com> |
|
|
|
|
|
|
|
|
@ -676,7 +676,7 @@ Markdown 會轉成:
@@ -676,7 +676,7 @@ Markdown 會轉成:
|
|
|
|
|
|
|
|
|
|
在瀏覽器裡面,這段字串會變成一個可以點擊的 "address@example.com" 連結。 |
|
|
|
|
|
|
|
|
|
(這種作法雖然可以混淆不少的機器人,但並無法全部檔下來,不過這樣也比什麼都不做還好不管如何,公開你的信箱終究是會引來廣告信件的。) |
|
|
|
|
(這種作法雖然可以混淆不少的機器人,但並無法全部檔下來,不過這樣也比什麼都不做好些。無論如何,公開你的信箱終究是會引來廣告信件的。) |
|
|
|
|
|
|
|
|
|
<h3 id="backslash">跳脫字元</h3> |
|
|
|
|
|
|
|
|
|