diff --git a/syntax.md b/syntax.md index dbe9ebe..d2ad0f3 100644 --- a/syntax.md +++ b/syntax.md @@ -55,7 +55,7 @@ Markdown 將容易閱讀和容易寫作這兩點作為主要目標。 為了這個目的，Markdown 的語法全部由標點符號來組成，標點符號的選擇是依 據他們看起來樣子或是他們的意義慎重的考慮的，像是在文字兩旁加上星號，看 -起來就很像在 \*強調\* 。Markdow 的清單就很像是清單，區塊引研究很像是電 +起來就很像在 \*強調\* 。Markdow 的清單就很像是清單，區塊引言就很像是電 子郵件的引言。

行內 HTML

@@ -63,8 +63,8 @@ Markdown 將容易閱讀和容易寫作這兩點作為主要目標。 Markdown 的語法有個主要的目的：用來作為一種網路內容的 *寫作* 用語言。 Markdown 不是要來取代 HTML，甚至也沒有要和它相似，它的語法種類不多， -只和 HTML 的一部分有關係，重點 *不是* 要創造一種更容易插入 HTML 標籤 -的語法，我認為 HTML 已經很容易插入了，Markdown 的重點在讓文件更容易 +只和 HTML 的一部分有關係，重點 *不是* 要創造一種更容易寫作 HTML 文件 +的語法，我認為 HTML 已經很容易寫了，Markdown 的重點在讓文件更容易 閱讀、編寫，HTML 是一種 *發佈* 的格式，Markdown 是一種 *編寫* 的格式， 因此，Markdown 的格式語法只涵蓋純文字可以涵蓋的範圍。 @@ -91,13 +91,13 @@ Markdown 不是要來取代 HTML，甚至也沒有要和它相似，它的語法 請注意，在 HTML 區塊標籤內，是不會對 Markdown 的語法進行處理的。例如， HTML 區塊內，無法使用 Markdown 形式的 `*強調*` -HTML 的跨度標間如 ``, `` 或者 `` 則不受限制，可以在 -Markdown 的段落、清單或是檔頭裡任意使用。依照個人習慣，甚至可以不用 +HTML 的區段標間如 ``, `` 或者 `` 則不受限制，可以在 +Markdown 的段落、清單或是標題裡任意使用。依照個人習慣，甚至可以不用 Markdown 格式，而採用 HTML 標籤來格式化。舉例說明：如果比較喜歡 HTML 的 `` 或 `` 標籤，可以直接使用這些標籤，而不用 Markdown 提 供的連結或是影像標示語法。 -HTML 跨度標籤和區塊標籤不同，在跨度標籤的範圍內， Markdown 的語法是有效的。 +HTML 區段標籤和區塊標籤不同，在區段標籤的範圍內， Markdown 的語法是有效的。

特殊字元自動轉換

@@ -106,7 +106,7 @@ HTML 跨度標籤和區塊標籤不同，在跨度標籤的範圍內， Markdown 使用實體的形式，像是 `<` 和 `&`。 `&` 符號其實很讓寫作網路文件的人很困擾，如果你要打 'AT&T' ，你必須要寫成 -'`AAT&T`' ，你還必須要轉換網址內的 `&` 符號，如果你要連結到： +'`AT&T`' ，你還必須要轉換網址內的 `&` 符號，如果你要連結到： 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 -才能放到你的連結標籤的 `href` 裡，不用說，這很容易忘記，可能是最大的 -HTML 標準檢查的錯誤來源。 +才能放到你的連結標籤的 `href` 裡，不用說也知道這很容易忘記，這也可能是數量最多的 +HTML 標準檢查的錯誤。 Markdown 允許你直接使用這些符號，但是你要小心跳脫字元的使用，如果你是在 HTML 實體中使用 `&` 符號的話，它不會被轉換，而在其它情形下，它則會被轉換 @@ -133,7 +133,7 @@ Markdown 就會將它轉為： AT&T -類似的狀況也會發生在 `<` 符號上，因為 Markdown 支援 [inline HTML](#html) ， +類似的狀況也會發生在 `<` 符號上，因為 Markdown 支援 [行內 HTML](#html) ， 如果你是使用 `<` 符號作為 HTML 標籤使用，那 Markdown 也不會對它做任何轉換， 但是如果你是寫： @@ -146,7 +146,7 @@ Markdown 將會把它轉換為： 不過要注意的是，code 範圍內，不論是行內還是區塊， `<` 和 `&` 兩個符號都 *一定* 會被轉換成 HTML 實體，這項特性讓你可以很容易的用 Markdown 寫 HTML code （和 HTML 相對而言， HTML 語法中，你要把所有的 `<` 和 `&` 都轉換為 HTML 實體， -你才能再 HTML 文件裡面寫出 HTML code） +你才能在 HTML 文件裡面寫出 HTML code） * * * @@ -155,11 +155,11 @@ Markdown 將會把它轉換為：

段落和換行

-一個段落是由一個以上的連接的行句組成，而一個以上的空行則會切分出不同的段落 +一個段落是由一個以上連接的行句組成，而一個以上的空行則會切分出不同的段落 （空行的定義是顯示上看起來像是空行，就被視為空行，例如有一行只有空白和 tab， 那該行也會被視為空行），一般的段落不需要用空白或斷行縮排。 -「一個或以上的連接的行句組成」這句其實暗示了 Markdow 允許段落內的強迫斷行， +「一個以上連接的行句組成」這句其實暗示了 Markdow 允許段落內的強迫斷行， 這個特性和其他大部分的 text-to-HTML 格式不一樣（包括 MovableType 的 "Convert Line Breaks" 選項），其它的格式會把每個斷行都轉成 `
` 標籤。 @@ -167,7 +167,7 @@ Markdown 將會把它轉換為： 是的，這確實讓你要花比較多功夫插入 `
` ，但是「每個換行都轉換為 `
`」 的方法在 Markdown 中並不適合， Markdown 的 email 式的 [區塊引言][bq] 和多段落的 -[清單][l] 在使用換行來排版的時候，不但更好用，還更好看！ +[清單][l] 在使用換行來排版的時候，不但更好用，還更好閱讀！ [bq]: #blockquote [l]: #list @@ -187,7 +187,7 @@ Setext 形式是用底線的形式，利用 `=` （最高階標題）和 `-` （ 任何數量的 `=` 和 `-` 都可以有效果。 -Atx 形式在行首插入 1 到 6 個 `#` ，對應到標題 1 到 6 階，例如： +Atx 形式則是在行首插入 1 到 6 個 `#` ，對應到標題 1 到 6 階，例如： # This is an H1 @@ -267,7 +267,7 @@ Markdown 支援有序清單和無序清單。 + Green + Blue -和： +也等同於： - Red - Green @@ -642,7 +642,7 @@ Markdown 使用星號 (`*`) 和底線 (`_`) 作為標記強調字詞的符號， un*frigging*believable -但日如果你的 `*` 和 `_` 兩邊都有空白的話，它們就只會被當成普通的符號。 +但是如果你的 `*` 和 `_` 兩邊都有空白的話，它們就只會被當成普通的符號。 如果要在文字前後直接插入普通的星號或底線，你可以用反斜線： @@ -760,7 +760,7 @@ Markdown 會轉成： 在瀏覽器裡面，這段字串會變成一個可以點擊的 "address@example.com" 連結。 -（這種作法雖然可以混淆不少的機器人，但並不是全部，不過這樣也比什麼都不做還好 +（這種作法雖然可以混淆不少的機器人，但並無法全部檔下來，不過這樣也比什麼都不做還好 不管如何，公開你的信箱終究是會引來廣告信件的。）

跳脫字元