diff --git a/syntax.md b/syntax.md index 7c9d953..f228e15 100644 --- a/syntax.md +++ b/syntax.md @@ -49,11 +49,11 @@ Markdown 的目標是實現「易讀易寫」。 [5]: http://www.triptico.com/software/grutatxt.html [6]: http://ettext.taint.org/doc/ -因此 Markdown 的語法完全是由標點符號所組成,並且經過謹慎考慮,為的是看起來就像是它們所要表達的意思。像是在文字兩旁加上星號,看起來就像 \*強調\* 。Markdown 的清單看起來,嗯,就是清單。假如你有使用過電子郵件,區塊引言看起來就真的是引用一段文字。 +因此 Markdown 的語法全由標點符號所組成,並且經過謹慎考慮,為的是讓它們看起來就像所要表達的意思。像是在文字兩旁加上星號,看起來就像\*強調\*。Markdown 的清單看起來,嗯,就是清單。假如你有使用過電子郵件,區塊引言看起來就真的像是引用一段文字。

行內 HTML

-Markdown 的語法有個主要的目的:用來作為一種網路內容的 *寫作* 用語言。 +Markdown 的語法有個主要的目的:用來作為一種網路內容的*寫作*用語言。 Markdown 不是要來取代 HTML,甚至也沒有要和它相似,它的語法種類不多,只和 HTML 的一部分有關係,重點 *不是* 要創造一種更容易寫作 HTML 文件的語法,我認為 HTML 已經很容易寫了,Markdown 的重點在讓文件更容易閱讀、編寫,HTML 是一種 *發佈* 的格式,Markdown 是一種 *編寫* 的格式,因此,Markdown 的格式語法只涵蓋純文字可以涵蓋的範圍。 @@ -75,7 +75,7 @@ Markdown 不是要來取代 HTML,甚至也沒有要和它相似,它的語法 請注意,在 HTML 區塊標籤內,是不會對 Markdown 的語法進行處理的。例如,HTML 區塊內,無法使用 Markdown 形式的 `*強調*` -HTML 的區段標間如 ``, `` 或者 `` 則不受限制,可以在Markdown 的段落、清單或是標題裡任意使用。依照個人習慣,甚至可以不用Markdown 格式,而採用 HTML 標籤來格式化。舉例說明:如果比較喜歡 HTML 的 `` 或 `` 標籤,可以直接使用這些標籤,而不用 Markdown 提供的連結或是影像標示語法。 +HTML 的區段標間如 ``, `` 或者 `` 則不受限制,可以在 Markdown 的段落、清單或是標題裡任意使用。依照個人習慣,甚至可以不用Markdown 格式,而採用 HTML 標籤來格式化。舉例說明:如果比較喜歡 HTML 的 `` 或 `` 標籤,可以直接使用這些標籤,而不用 Markdown 提供的連結或是影像標示語法。 HTML 區段標籤和區塊標籤不同,在區段標籤的範圍內, Markdown 的語法是有效的。 @@ -124,7 +124,7 @@ Markdown 將會把它轉換為: 一個段落是由一個以上連接的行句組成,而一個以上的空行則會切分出不同的段落(空行的定義是顯示上看起來像是空行,就被視為空行,例如有一行只有空白和 tab,那該行也會被視為空行),一般的段落不需要用空白或斷行縮排。 -「一個以上連接的行句組成」這句其實暗示了 Markdow 允許段落內的強迫斷行,這個特性和其他大部分的 text-to-HTML 格式不一樣(包括 MovableType 的 "Convert Line Breaks" 選項),其它的格式會把每個斷行都轉成 `
` 標籤。 +「一個以上連接的行句組成」這句其實暗示了 Markdown 允許段落內的強迫斷行,這個特性和其他大部分的 text-to-HTML 格式不一樣(包括 MovableType 的 "Convert Line Breaks" 選項),其它的格式會把每個斷行都轉成 `
` 標籤。 如果你 *真的* 是想要插入 `
` 標籤的話,在行尾加上兩個以上的空白,然後按 enter。 @@ -155,7 +155,7 @@ Atx 形式則是在行首插入 1 到 6 個 `#` ,對應到標題 1 到 6 階 ###### This is an H6 -你可以選擇性的 "關閉" atx 樣式的標題,這純粹只是美觀用的,你如果覺得這樣看起來比較好,就可以加上 `#` 在行尾,而行尾的 `#` 數量也不用和開頭一樣(行首的數量決定標題的階數): +你可以選擇性地「關閉」atx 樣式的標題,這純粹只是美觀用的,你如果覺得這樣看起來比較好,就可以加上 `#` 在行尾,而行尾的 `#` 數量也不用和開頭一樣(行首的數量決定標題的階數): # This is an H1 # @@ -253,7 +253,7 @@ Markdown 支援有序清單和無序清單。 1. McHale 8. Parish -你都會得到完全一樣的 HTML 輸出,重點在於,你可以讓你的 Markdown 文件的清單數字和輸出的結果一樣,或是你懶一點,你可以完全不用在意數字的正確性。 +你都會得到完全一樣的 HTML 輸出。重點在於,你可以讓 Markdown 文件的清單數字和輸出的結果相同,或是你懶一點,你可以完全不用在意數字的正確性。 如果你使用懶惰的寫法,建議第一個項目最好還是從 1. 開始,因為 Markdown 未來可能會支援有序清單的 start 屬性。 @@ -301,7 +301,7 @@ Markdown 支援有序清單和無序清單。
  • Magic

  • -清單項目可以包含多個段落,每個項目下的端落都必須要縮排 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 支援有序清單和無序清單。 2. Suspendisse id sem consectetuer libero luctus adipiscing. -如果你每行都有縮排,看起來會看好很多,當然,再次的,如果你很懶惰,Markdown 也允許: +如果你每行都有縮排,看起來會看好很多,當然,再次地,如果你很懶惰,Markdown 也允許: * This is a list item with two paragraphs. @@ -379,9 +379,9 @@ Markdown 會轉換成: end tell -一個程式碼區塊會一直持續到碰到沒有縮排的行(或是文件結尾)。 +一個程式碼區塊會一直持續到碰到沒有縮排的那一行(或是文件結尾)。 -在程式碼區塊裡面, `&` 、 `<` 和 `>` 會自動轉成 HTML 實體,這樣的方式會讓你非常容易使用 Markdown 插入範例用的 HTML 原始碼,只需要複製貼上,然後縮排就可以了,剩下的 Markdown 都會幫你處理,例如: +在程式碼區塊裡面, `&` 、 `<` 和 `>` 會自動轉成 HTML 實體,這樣的方式讓你非常容易使用 Markdown 插入範例用的 HTML 原始碼,只需要複製貼上,然後縮排就可以了,剩下的 Markdown 都會幫你處理,例如: