diff --git a/content.html b/content.html index 5084bb0..331d1a1 100644 --- a/content.html +++ b/content.html @@ -35,7 +35,7 @@ Document. Please refer to 感謝 -

Note: 這份文件是用 Markdown 寫的，你可以 看看他的原始檔 。

+

注意：這份文件是用 Markdown 寫的，你可以看看它的原始檔 。

@@ -43,21 +43,21 @@ Document. Please refer to 哲學 -

Markdown 將容易閱讀和容易寫作這兩點作為主要目標。

+

Markdown 的目標是實現「易讀易寫」。

-

可讀性則是其中最重要的一個特點，一篇 Markdown 格式的文件應該要可以直接作為發佈用的文件，而不會讓人覺得他是使用像是邊簽語言之類的格式來編寫，Markdown 的文件格式受到很多的 text-to-HTML 格式的影響，包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText，然而影響最大的其實是純文字的電子郵件。

+

不過最需要強調的便是它的可讀性。一份使用 Markdown 格式撰寫的文件應該可以直接以純文字發佈，並且看起來不像是被許多的標籤或者是格式指令所構成。Markdown 語法受到一些既有 text-to-HTML 格式的影響，包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText，然而最大靈感來源其實是純文字的電子郵件格式。

-

為了這個目的，Markdown 的語法全部由標點符號來組成，標點符號的選擇是依據他們看起來樣子或是他們的意義慎重的考慮的，像是在文字兩旁加上星號，看起來就很像在 *強調* 。Markdow 的清單就很像是清單，區塊引言就很像是電子郵件的引言。

+

因此 Markdown 的語法全由標點符號所組成，並經過嚴謹慎選，是為了讓它們看起來就像所要表達的意思。像是在文字兩旁加上星號，看起來就像*強調*。Markdown 的清單看起來，嗯，就是清單。假如你有使用過電子郵件，區塊引言看起來就真的像是引用一段文字。

行內 HTML

-

Markdown 的語法有個主要的目的：用來作為一種網路內容的 寫作 用語言。

+

Markdown 的語法有個主要的目的：用來作為一種網路內容的寫作用語言。

-

Markdown 不是要來取代 HTML，甚至也沒有要和它相似，它的語法種類不多，只和 HTML 的一部分有關係，重點 不是 要創造一種更容易寫作 HTML 文件的語法，我認為 HTML 已經很容易寫了，Markdown 的重點在讓文件更容易閱讀、編寫，HTML 是一種 發佈 的格式，Markdown 是一種 編寫 的格式，因此，Markdown 的格式語法只涵蓋純文字可以涵蓋的範圍。

+

Markdown 不是要來取代 HTML，甚至也沒有要和它相似，它的語法種類不多，只和 HTML 的一部分有關係，重點不是要創造一種更容易寫作 HTML 文件的語法，我認為 HTML 已經很容易寫了，Markdown 的重點在於，它能讓文件更容易閱讀、編寫。HTML 是一種發佈的格式，Markdown 是一種編寫的格式，因此，Markdown 的格式語法只涵蓋純文字可以涵蓋的範圍。

不在 Markdown 涵蓋範圍之外的標籤，都可以直接在文件裡面用 HTML 撰寫。不需要額外標註這是 HTML 或是 Markdown；只要直接加標籤就可以了。

-

只有區塊元素──比如 <div>,<table>, <pre>, <p> 等標籤，必需在前後加上空白，以利與內容區隔。而且這些的開始與結尾標籤，不可以用 tab 或是空白來縮排。Markdown 的產生器有智慧型判斷，可以避免在區塊標籤前後加上沒有必要的 <p> 標籤。

+

只有區塊元素──比如 <div>、<table>、<pre>、<p> 等標籤，必需在前後加上空白，以利與內容區隔。而且這些（元素）的開始與結尾標籤，不可以用 tab 或是空白來縮排。Markdown 的產生器有智慧型判斷，可以避免在區塊標籤前後加上沒有必要的 <p> 標籤。

舉例來說，在 Markdown 文件裡加上一段 HTML 表格：

@@ -72,9 +72,9 @@ Document. Please refer to 段落和換行 -

一個段落是由一個以上連接的行句組成，而一個以上的空行則會切分出不同的段落（空行的定義是顯示上看起來像是空行，就被視為空行，例如有一行只有空白和 tab，那該行也會被視為空行），一般的段落不需要用空白或斷行縮排。

+

一個段落是由一個以上相連接的行句組成，而一個以上的空行則會切分出不同的段落（空行的定義是顯示上看起來像是空行，便會被視為空行。比方說，若某一行只包含空白和 tab，則該行也會被視為空行），一般的段落不需要用空白或斷行縮排。

-

「一個以上連接的行句組成」這句其實暗示了 Markdow 允許段落內的強迫斷行，這個特性和其他大部分的 text-to-HTML 格式不一樣（包括 MovableType 的 "Convert Line Breaks" 選項），其它的格式會把每個斷行都轉成 <br /> 標籤。

+

「一個以上相連接的行句組成」這句話其實暗示了 Markdown 允許段落內的強迫斷行，這個特性和其他大部分的 text-to-HTML 格式不一樣（包括 MovableType 的「Convert Line Breaks」選項），其它的格式會把每個斷行都轉成 <br /> 標籤。

-

如果你 真的 是想要插入 <br /> 標籤的話，在行尾加上兩個以上的空白，然後按 enter。

+

如果你真的想要插入 <br /> 標籤的話，在行尾加上兩個以上的空白，然後按 enter。

-

是的，這確實讓你要花比較多功夫插入 <br /> ，但是「每個換行都轉換為 <br />」的方法在 Markdown 中並不適合， Markdown 的 email 式的 區塊引言 和多段落的清單 在使用換行來排版的時候，不但更好用，還更好閱讀！

+

是的，這確實需要花比較多功夫來插入 <br /> ，但是「每個換行都轉換為 <br />」的方法在 Markdown 中並不適合， Markdown 中 email 式的 區塊引言 和多段落的 清單 在使用換行來排版的時候，不但更好用，還更好閱讀。

@@ -159,7 +159,7 @@ This is an H2 ###### This is an H6 -

你可以選擇性的 "關閉" atx 樣式的標題，這純粹只是美觀用的，你如果覺得這樣看起來比較好，就可以加上 # 在行尾，而行尾的 # 數量也不用和開頭一樣（行首的數量決定標題的階數）：

+

你可以選擇性地「關閉」atx 樣式的標題，這純粹只是美觀用的，若是覺得這樣看起來比較舒適，你就可以在行尾加上 #，而行尾的 # 數量也不用和開頭一樣（行首的井字數量決定標題的階數）：

# This is an H1 #
 
@@ -170,7 +170,7 @@ This is an H2
 
 
Blockquotes

 
-
Markdown 使用 email 形式的區塊引言，如果你很清楚在 email 信件中如何引言，你就知道如何在 Markdown 文件中建立一個區塊引言，那會看起來像是你強迫斷行，然後在每行的最前面加上 > ：

+
Markdown 使用 email 形式的區塊引言，如果你很熟悉如何在 email 信件中引言，你就知道怎麼在 Markdown 文件中建立一個區塊引言，那會看起來像是你強迫斷行，然後在每行的最前面加上 > ：

 
 
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
 > consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
@@ -211,7 +211,7 @@ id sem consectetuer libero luctus adipiscing.
 >     return shell_exec("echo $input | $markdown_script");
 

 
-
任何標準的文字編輯器都可以簡單的建立 email 樣式的引言，例如 BBEdit ，你可以選取文字後然後從選單中選擇 增加引言階層 。

+
任何標準的文字編輯器都能簡單地建立 email 樣式的引言，例如 BBEdit ，你可以選取文字後然後從選單中選擇增加引言階層。

 
 
清單

 
@@ -245,7 +245,7 @@ id sem consectetuer libero luctus adipiscing.
 3.  Parish
-

很重要的一點是：你的清單標記上的數字並不會影響輸出的 HTML 結果，上面的清單所產生的 HTML 標記為：

+

很重要的一點是，你在清單標記上使用的數字並不會影響輸出的 HTML 結果，上面的清單所產生的 HTML 標記為：

<ol>
 <li>Bird</li>
@@ -268,7 +268,7 @@ id sem consectetuer libero luctus adipiscing.
 8. Parish
-

你都會得到完全一樣的 HTML 輸出，重點在於，你可以讓你的 Markdown 文件的清單數字和輸出的結果一樣，或是你懶一點，你可以完全不用在意數字的正確性。

+

你都會得到完全相同的 HTML 輸出。重點在於，你可以讓 Markdown 文件的清單數字和輸出的結果相同，或是你懶一點，你可以完全不用在意數字的正確性。

如果你使用懶惰的寫法，建議第一個項目最好還是從 1. 開始，因為 Markdown 未來可能會支援有序清單的 start 屬性。

@@ -322,7 +322,7 @@ Suspendisse id sem consectetuer libero luctus adipiscing. </ul> -

清單項目可以包含多個段落，每個項目下的端落都必須要縮排 4 個空白或是一個 tab ：

+

清單項目可以包含多個段落，每個項目下的段落都必須縮排 4 個空白或是一個 tab ：

1.  This is a list item with two paragraphs. Lorem ipsum dolor
     sit amet, consectetuer adipiscing elit. Aliquam hendrerit
@@ -335,7 +335,7 @@ Suspendisse id sem consectetuer libero luctus adipiscing.
 2.  Suspendisse id sem consectetuer libero luctus adipiscing.
-

如果你每行都有縮排，看起來會看好很多，當然，再次的，如果你很懶惰，Markdown 也允許：

+

如果你每行都有縮排，看起來會看好很多，當然，再次地，如果你很懶惰，Markdown 也允許：

*   This is a list item with two paragraphs.
 
@@ -354,7 +354,7 @@ sit amet, consectetuer adipiscing elit.
     > inside a list item.
-

如果要放程式碼區塊的話，該區塊就需要縮排 兩次 ，也就是 8 個空白或是兩個 tab：

+

如果要放程式碼區塊的話，該區塊就需要縮排兩次 ，也就是 8 個空白或是兩個 tab：

*   A list item with a code block:
 
@@ -366,16 +366,16 @@ sit amet, consectetuer adipiscing elit.
 
1986. What a great season.
 

 
-
換句話說，也就是在行首出現 數字-句點-空白 ，要避免這樣的狀況，你可以在句點前面加上反斜線。

+
換句話說，也就是在行首出現數字-句點-空白，要避免這樣的狀況，你可以在句點前面加上反斜線。

 
 
1986\. What a great season.
 

 
 
程式碼區塊

 
-
和程式相關的寫作或是標籤語言原始碼通常會有已經排版好的程式碼區塊，通常這些區塊我們並不希望它照一般段落文件的方式去排版，而是照原來的樣子顯示，Markdown 會用 <pre> 和 <code> 標籤來把程式碼區塊包起來。

+
和程式相關的寫作或是標籤語言原始碼通常會有已經排版好的程式碼區塊，通常這些區塊我們並不希望它以一般段落文件的方式去排版，而是照原來的樣子顯示，Markdown 會用 <pre> 和 <code> 標籤來把程式碼區塊包起來。

 
-
在 Markdown 中要建立程式碼區塊很簡單，只要簡單的縮排 4 個空白或是 1 個 tab 就可以，例如，下面的輸入：

+
要在 Markdown 中建立程式碼區塊很簡單，只要簡單地縮排 4 個空白或是 1 個 tab 就可以，例如，下面的輸入：

 
 
This is a normal paragraph:
 
@@ -409,9 +409,9 @@ end tell
 </code></pre>
 

 
-
一個程式碼區塊會一直持續到碰到沒有縮排的行（或是文件結尾）。

+
一個程式碼區塊會一直持續到沒有縮排的那一行（或是文件結尾）。

 
-
在程式碼區塊裡面， & 、 < 和 > 會自動轉成 HTML 實體，這樣的方式會讓你非常容易使用 Markdown 插入範例用的 HTML 原始碼，只需要複製貼上，然後縮排就可以了，剩下的 Markdown 都會幫你處理，例如：

+
在程式碼區塊裡面， & 、 < 和 > 會自動轉成 HTML 實體，這樣的方式讓你非常容易使用 Markdown 插入範例用的 HTML 原始碼，只需要複製貼上，再加上縮排就可以了，剩下的 Markdown 都會幫你處理，例如：

 
 
    <div class="footer">
         &copy; 2004 Foo Corporation
@@ -426,11 +426,11 @@ end tell
 </code></pre>
 

 
-
程式碼區塊中，一般的 Markdown 語法不會被轉換，像是星號就只會是星號，這表示你可以很容易用 Markdown 語法寫 Markdown 語法相關的文件。

+
程式碼區塊中，一般的 Markdown 語法不會被轉換，像是星號便只是星號，這表示你可以很容易地以 Markdown 語法撰寫 Markdown 語法相關的文件。

 
 
分隔線

 
-
你可以用在一行內用三個或以上的星號、減號、底線來建立一個分隔線，行內不能有其他東西，你也可以在星號中間插入空白，下面每種寫法都可以建立分隔線：

+
你可以在一行中用三個或以上的星號、減號、底線來建立一個分隔線，行內不能有其他東西。你也可以在星號中間插入空白。下面每種寫法都可以建立分隔線：

 
 
* * *
 
@@ -449,7 +449,7 @@ end tell
 
 
 
-
Markdown 支援兩種形式的連結語法： 行內 和 參考 兩種形式。

+
Markdown 支援兩種形式的連結語法： 行內和參考兩種形式。

 
 
不管是哪一種，連結的文字都是用 [方括號] 來標記。

 
@@ -474,12 +474,12 @@ title attribute.</p>
 
See my [About](/about/) page for details.
 

 
-
參考形式的連結使用另外一個方括號接在連結文字的括號後面，而在第二個方括號裡面要填入連結的辨識用的標籤：

+
參考形式的連結使用另外一個方括號接在連結文字的括號後面，而在第二個方括號裡面要填入用以辨識連結的標籤：

 
 
This is [an example][id] reference-style link.
 

 
-
你也可以選擇性的在兩個方括號中間加上空白：

+
你也可以選擇性地在兩個方括號中間加上空白：

 
 
This is [an example] [id] reference-style link.
 

@@ -496,7 +496,7 @@ title attribute.</p>
 
  • 接著一個分號
    • 
 
  • 接著一個以上的空白或 tab
    • 
 
  • 接著連結的網址
    • 
-
  • 選擇性的接著 title 內容，可以用單引號、雙引號或是括弧包著
    • 
+
  • 選擇性地接著 title 內容，可以用單引號、雙引號或是括弧包著
    • 
 
 
 
    下面這三種連結的定義都是相同：
    
@@ -506,8 +506,7 @@ title attribute.</p>
 [foo]: http://example.com/  (Optional Title Here)
 
    
 
-
    Note: 有一個已知的問題是 Markdown.pl 1.0.1 會忽略單引號包起來的
-連結 title。
    
+
    請注意： 有一個已知的問題是 Markdown.pl 1.0.1 會忽略單引號包起來的連結 title。
    
 
 
    連結網址也可以用角括號包起來：
    
 
@@ -522,13 +521,13 @@ title attribute.</p>
 
 
    網址定義只有在產生連結的時候用到，並不會直接出現在文件之中。
    
 
-
    連結辨識標籤可以有字母、數字、空白和標點符號，但是並 不 分大小寫，因此下面兩個連結是一樣的：
    
+
    連結辨識標籤可以有字母、數字、空白和標點符號，但是並不區分大小寫，因此下面兩個連結是一樣的：
    
 
 
    [link text][a]
 [link text][A]
 
    
 
-
    預設的連結標籤 功能讓你可以省略指定連結標籤，這種情形下，連結標籤和連結文字會視為相同，要用預設連結標籤只要在連結文字後面加上一個空的角括號，如果你要讓 "Google" 連結到 google.com，你可以簡化成：
    
+
    預設的連結標籤功能讓你可以省略指定連結標籤，這種情形下，連結標籤和連結文字會視為相同，要用預設連結標籤只要在連結文字後面加上一個空的角括號，如果你要讓 "Google" 連結到 google.com，你可以簡化成：
    
 
 
    [Google][]
 
    
@@ -578,7 +577,7 @@ title="Google">Google</a> than from
 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
@@ -591,7 +590,7 @@ than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
 
 
    強調
    
 
-
    Markdown 使用星號 (*) 和底線 (_) 作為標記強調字詞的符號，被 * 或_ 包圍的字詞會被轉成用 <em> 標籤包圍，用兩個 * 或 _ 包起來的話，則會被轉成 <strong> ，例如：
    
+
    Markdown 使用星號（*）和底線（_）作為標記強調字詞的符號，被 * 或 _ 包圍的字詞會被轉成用 <em> 標籤包圍，用兩個 * 或 _ 包起來的話，則會被轉成 <strong>，例如：
    
 
 
    *single asterisks*
 
@@ -629,7 +628,7 @@ __double underscores__
 
 
    程式碼
    
 
-
    如果要標記一小段行內程式碼，你可以用反引號把它包起來 (`)，例如：
    
+
    如果要標記一小段行內程式碼，你可以用反引號把它包起來（`），例如：
    
 
 
    Use the `printf()` function.
 
    
@@ -663,7 +662,7 @@ A backtick-delimited string in a code span: `` `foo` ``
 <p>A backtick-delimited string in a code span: <code>`foo`</code></p>
 
    
 
-
    在程式碼區段內， & 和角括號都會被轉成 HTML 實體，這樣會比較容易插入 HTML 原始碼，Markdown 會把下面這段：
    
+
    在程式碼區段內，& 和角括號都會被轉成 HTML 實體，這樣會比較容易插入 HTML 原始碼，Markdown 會把下面這段：
    
 
 
    Please don't use any `<blink>` tags.
 
    
@@ -686,9 +685,9 @@ equivalent of <code>&amp;mdash;</code>.</p>
 
 
    圖片
    
 
-
    很明顯的，要設計一個 "自然" 的語法來在文字中插入圖片是很有難度的。
    
+
    很明顯地，要在純文字應用中設計一個 「自然」的語法來插入圖片是有一定難度的。
    
 
-
    Markdown 使用一種和連結很像的語法來標記圖片，同樣也允許兩種樣式： 行內 和 參考 。
    
+
    Markdown 使用一種和連結很相似的語法來標記圖片，同樣也允許兩種樣式： 行內和參考。
    
 
 
    行內圖片的語法看起來像是：
    
 
@@ -711,7 +710,7 @@ equivalent of <code>&amp;mdash;</code>.</p>
 
    ![Alt text][id]
 
    
 
-
    "id" 是圖片參考的名稱，圖片參考的定義方式則和連結參考一樣：
    
+
    「id」是圖片參考的名稱，圖片參考的定義方式則和連結參考一樣：
    
 
 
    [id]: url/to/image  "Optional title attribute"
 
    
@@ -734,7 +733,7 @@ equivalent of <code>&amp;mdash;</code>.</p>
 
    <a href="http://example.com/">http://example.com/</a>
 
    
 
-
    自動的郵件連結也很類似，只是 Markdown 會先做一個編碼轉換的過程，把文字字元轉成16進位碼的 HTML 實體，這樣的格式可以混淆一些不好的信箱位置收集機器人，例如：
    
+
    自動的郵件連結也很類似，只是 Markdown 會先做一個編碼轉換的過程，把文字字元轉成 16 進位碼的 HTML 實體，這樣的格式可以混淆一些不好的信箱地址收集機器人，例如：
    
 
 
    <address@example.com>
 
    
@@ -747,13 +746,13 @@ equivalent of <code>&amp;mdash;</code>.</p>
 &#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;</a>
    -

    在瀏覽器裡面，這段字串會變成一個可以點擊的 "address@example.com" 連結。

    +

    在瀏覽器裡面，這段字串會變成一個可以點擊的「address@example.com」連結。

    -

    （這種作法雖然可以混淆不少的機器人，但並無法全部檔下來，不過這樣也比什麼都不做還好不管如何，公開你的信箱終究是會引來廣告信件的。）

    +

    （這種作法雖然可以混淆不少的機器人，但並無法全部擋下來，不過這樣也比什麼都不做好些。無論如何，公開你的信箱終究會引來廣告信件的。）

    跳脫字元

    -

    Markdown 可以利用反斜線來插入一些在語法中有其他意義的符號，例如：如果你想要用星號加在文字旁邊的方式來做出強調效果（但是不是用 <em> 標籤），你可以在星號的前面加上反斜線：

    +

    Markdown 可以利用反斜線來插入一些在語法中有其它意義的符號，例如：如果你想要用星號加在文字旁邊的方式來做出強調效果（但不用 <em> 標籤），你可以在星號的前面加上反斜線：

    \*literal asterisks\*
    @@ -776,4 +775,4 @@ _ 底線

    感謝

    -

    感謝 leafy7382 協助翻譯， ethantw 的 漢字標準格式・CSS Reset 。

    +

    感謝 leafy7382 協助翻譯，ethantw 的漢字標準格式・CSS Reset。

    diff --git a/index.html b/index.html index b6247af..556d8c0 100644 --- a/index.html +++ b/index.html @@ -46,7 +46,7 @@ Document. Please refer to 感謝 -

    Note: 這份文件是用 Markdown 寫的，你可以 看看他的原始檔 。

    +

    注意：這份文件是用 Markdown 寫的，你可以看看它的原始檔 。

    @@ -54,21 +54,21 @@ Document. Please refer to 哲學 -

    Markdown 將容易閱讀和容易寫作這兩點作為主要目標。

    +

    Markdown 的目標是實現「易讀易寫」。

    -

    可讀性則是其中最重要的一個特點，一篇 Markdown 格式的文件應該要可以直接作為發佈用的文件，而不會讓人覺得他是使用像是邊簽語言之類的格式來編寫，Markdown 的文件格式受到很多的 text-to-HTML 格式的影響，包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText，然而影響最大的其實是純文字的電子郵件。

    +

    不過最需要強調的便是它的可讀性。一份使用 Markdown 格式撰寫的文件應該可以直接以純文字發佈，並且看起來不像是被許多的標籤或者是格式指令所構成。Markdown 語法受到一些既有 text-to-HTML 格式的影響，包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText，然而最大靈感來源其實是純文字的電子郵件格式。

    -

    為了這個目的，Markdown 的語法全部由標點符號來組成，標點符號的選擇是依據他們看起來樣子或是他們的意義慎重的考慮的，像是在文字兩旁加上星號，看起來就很像在 *強調* 。Markdow 的清單就很像是清單，區塊引言就很像是電子郵件的引言。

    +

    因此 Markdown 的語法全由標點符號所組成，並經過嚴謹慎選，是為了讓它們看起來就像所要表達的意思。像是在文字兩旁加上星號，看起來就像*強調*。Markdown 的清單看起來，嗯，就是清單。假如你有使用過電子郵件，區塊引言看起來就真的像是引用一段文字。

    行內 HTML

    -

    Markdown 的語法有個主要的目的：用來作為一種網路內容的 寫作 用語言。

    +

    Markdown 的語法有個主要的目的：用來作為一種網路內容的寫作用語言。

    -

    Markdown 不是要來取代 HTML，甚至也沒有要和它相似，它的語法種類不多，只和 HTML 的一部分有關係，重點 不是 要創造一種更容易寫作 HTML 文件的語法，我認為 HTML 已經很容易寫了，Markdown 的重點在讓文件更容易閱讀、編寫，HTML 是一種 發佈 的格式，Markdown 是一種 編寫 的格式，因此，Markdown 的格式語法只涵蓋純文字可以涵蓋的範圍。

    +

    Markdown 不是要來取代 HTML，甚至也沒有要和它相似，它的語法種類不多，只和 HTML 的一部分有關係，重點不是要創造一種更容易寫作 HTML 文件的語法，我認為 HTML 已經很容易寫了，Markdown 的重點在於，它能讓文件更容易閱讀、編寫。HTML 是一種發佈的格式，Markdown 是一種編寫的格式，因此，Markdown 的格式語法只涵蓋純文字可以涵蓋的範圍。

    不在 Markdown 涵蓋範圍之外的標籤，都可以直接在文件裡面用 HTML 撰寫。不需要額外標註這是 HTML 或是 Markdown；只要直接加標籤就可以了。

    -

    只有區塊元素──比如 <div>,<table>, <pre>, <p> 等標籤，必需在前後加上空白，以利與內容區隔。而且這些的開始與結尾標籤，不可以用 tab 或是空白來縮排。Markdown 的產生器有智慧型判斷，可以避免在區塊標籤前後加上沒有必要的 <p> 標籤。

    +

    只有區塊元素──比如 <div>、<table>、<pre>、<p> 等標籤，必需在前後加上空白，以利與內容區隔。而且這些（元素）的開始與結尾標籤，不可以用 tab 或是空白來縮排。Markdown 的產生器有智慧型判斷，可以避免在區塊標籤前後加上沒有必要的 <p> 標籤。

    舉例來說，在 Markdown 文件裡加上一段 HTML 表格：

    @@ -83,9 +83,9 @@ Document. Please refer to 段落和換行 -

    一個段落是由一個以上連接的行句組成，而一個以上的空行則會切分出不同的段落（空行的定義是顯示上看起來像是空行，就被視為空行，例如有一行只有空白和 tab，那該行也會被視為空行），一般的段落不需要用空白或斷行縮排。

    +

    一個段落是由一個以上相連接的行句組成，而一個以上的空行則會切分出不同的段落（空行的定義是顯示上看起來像是空行，便會被視為空行。比方說，若某一行只包含空白和 tab，則該行也會被視為空行），一般的段落不需要用空白或斷行縮排。

    -

    「一個以上連接的行句組成」這句其實暗示了 Markdow 允許段落內的強迫斷行，這個特性和其他大部分的 text-to-HTML 格式不一樣（包括 MovableType 的 "Convert Line Breaks" 選項），其它的格式會把每個斷行都轉成 <br /> 標籤。

    +

    「一個以上相連接的行句組成」這句話其實暗示了 Markdown 允許段落內的強迫斷行，這個特性和其他大部分的 text-to-HTML 格式不一樣（包括 MovableType 的「Convert Line Breaks」選項），其它的格式會把每個斷行都轉成 <br /> 標籤。

    -

    如果你 真的 是想要插入 <br /> 標籤的話，在行尾加上兩個以上的空白，然後按 enter。

    +

    如果你真的想要插入 <br /> 標籤的話，在行尾加上兩個以上的空白，然後按 enter。

    -

    是的，這確實讓你要花比較多功夫插入 <br /> ，但是「每個換行都轉換為 <br />」的方法在 Markdown 中並不適合， Markdown 的 email 式的 區塊引言 和多段落的清單 在使用換行來排版的時候，不但更好用，還更好閱讀！

    +

    是的，這確實需要花比較多功夫來插入 <br /> ，但是「每個換行都轉換為 <br />」的方法在 Markdown 中並不適合， Markdown 中 email 式的 區塊引言 和多段落的 清單 在使用換行來排版的時候，不但更好用，還更好閱讀。

    @@ -170,7 +170,7 @@ This is an H2 ###### This is an H6 -

    你可以選擇性的 "關閉" atx 樣式的標題，這純粹只是美觀用的，你如果覺得這樣看起來比較好，就可以加上 # 在行尾，而行尾的 # 數量也不用和開頭一樣（行首的數量決定標題的階數）：

    +

    你可以選擇性地「關閉」atx 樣式的標題，這純粹只是美觀用的，若是覺得這樣看起來比較舒適，你就可以在行尾加上 #，而行尾的 # 數量也不用和開頭一樣（行首的井字數量決定標題的階數）：

    # This is an H1 #
 
@@ -181,7 +181,7 @@ This is an H2
 
 
    Blockquotes
    
 
-
    Markdown 使用 email 形式的區塊引言，如果你很清楚在 email 信件中如何引言，你就知道如何在 Markdown 文件中建立一個區塊引言，那會看起來像是你強迫斷行，然後在每行的最前面加上 > ：
    
+
    Markdown 使用 email 形式的區塊引言，如果你很熟悉如何在 email 信件中引言，你就知道怎麼在 Markdown 文件中建立一個區塊引言，那會看起來像是你強迫斷行，然後在每行的最前面加上 > ：
    
 
 
    > This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
 > consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
@@ -222,7 +222,7 @@ id sem consectetuer libero luctus adipiscing.
 >     return shell_exec("echo $input | $markdown_script");
 
    
 
-
    任何標準的文字編輯器都可以簡單的建立 email 樣式的引言，例如 BBEdit ，你可以選取文字後然後從選單中選擇 增加引言階層 。
    
+
    任何標準的文字編輯器都能簡單地建立 email 樣式的引言，例如 BBEdit ，你可以選取文字後然後從選單中選擇增加引言階層。
    
 
 
    清單
    
 
@@ -256,7 +256,7 @@ id sem consectetuer libero luctus adipiscing.
 3.  Parish
    -

    很重要的一點是：你的清單標記上的數字並不會影響輸出的 HTML 結果，上面的清單所產生的 HTML 標記為：

    +

    很重要的一點是，你在清單標記上使用的數字並不會影響輸出的 HTML 結果，上面的清單所產生的 HTML 標記為：

    <ol>
 <li>Bird</li>
@@ -279,7 +279,7 @@ id sem consectetuer libero luctus adipiscing.
 8. Parish
    -

    你都會得到完全一樣的 HTML 輸出，重點在於，你可以讓你的 Markdown 文件的清單數字和輸出的結果一樣，或是你懶一點，你可以完全不用在意數字的正確性。

    +

    你都會得到完全相同的 HTML 輸出。重點在於，你可以讓 Markdown 文件的清單數字和輸出的結果相同，或是你懶一點，你可以完全不用在意數字的正確性。

    如果你使用懶惰的寫法，建議第一個項目最好還是從 1. 開始，因為 Markdown 未來可能會支援有序清單的 start 屬性。

    @@ -333,7 +333,7 @@ Suspendisse id sem consectetuer libero luctus adipiscing. </ul> -

    清單項目可以包含多個段落，每個項目下的端落都必須要縮排 4 個空白或是一個 tab ：

    +

    清單項目可以包含多個段落，每個項目下的段落都必須縮排 4 個空白或是一個 tab ：

    1.  This is a list item with two paragraphs. Lorem ipsum dolor
     sit amet, consectetuer adipiscing elit. Aliquam hendrerit
@@ -346,7 +346,7 @@ Suspendisse id sem consectetuer libero luctus adipiscing.
 2.  Suspendisse id sem consectetuer libero luctus adipiscing.
    -

    如果你每行都有縮排，看起來會看好很多，當然，再次的，如果你很懶惰，Markdown 也允許：

    +

    如果你每行都有縮排，看起來會看好很多，當然，再次地，如果你很懶惰，Markdown 也允許：

    *   This is a list item with two paragraphs.
 
@@ -365,7 +365,7 @@ sit amet, consectetuer adipiscing elit.
     > inside a list item.
    -

    如果要放程式碼區塊的話，該區塊就需要縮排 兩次 ，也就是 8 個空白或是兩個 tab：

    +

    如果要放程式碼區塊的話，該區塊就需要縮排兩次 ，也就是 8 個空白或是兩個 tab：

    *   A list item with a code block:
 
@@ -377,16 +377,16 @@ sit amet, consectetuer adipiscing elit.
 
    1986. What a great season.
 
    
 
-
    換句話說，也就是在行首出現 數字-句點-空白 ，要避免這樣的狀況，你可以在句點前面加上反斜線。
    
+
    換句話說，也就是在行首出現數字-句點-空白，要避免這樣的狀況，你可以在句點前面加上反斜線。
    
 
 
    1986\. What a great season.
 
    
 
 
    程式碼區塊
    
 
-
    和程式相關的寫作或是標籤語言原始碼通常會有已經排版好的程式碼區塊，通常這些區塊我們並不希望它照一般段落文件的方式去排版，而是照原來的樣子顯示，Markdown 會用 <pre> 和 <code> 標籤來把程式碼區塊包起來。
    
+
    和程式相關的寫作或是標籤語言原始碼通常會有已經排版好的程式碼區塊，通常這些區塊我們並不希望它以一般段落文件的方式去排版，而是照原來的樣子顯示，Markdown 會用 <pre> 和 <code> 標籤來把程式碼區塊包起來。
    
 
-
    在 Markdown 中要建立程式碼區塊很簡單，只要簡單的縮排 4 個空白或是 1 個 tab 就可以，例如，下面的輸入：
    
+
    要在 Markdown 中建立程式碼區塊很簡單，只要簡單地縮排 4 個空白或是 1 個 tab 就可以，例如，下面的輸入：
    
 
 
    This is a normal paragraph:
 
@@ -420,9 +420,9 @@ end tell
 </code></pre>
 
    
 
-
    一個程式碼區塊會一直持續到碰到沒有縮排的行（或是文件結尾）。
    
+
    一個程式碼區塊會一直持續到沒有縮排的那一行（或是文件結尾）。
    
 
-
    在程式碼區塊裡面， & 、 < 和 > 會自動轉成 HTML 實體，這樣的方式會讓你非常容易使用 Markdown 插入範例用的 HTML 原始碼，只需要複製貼上，然後縮排就可以了，剩下的 Markdown 都會幫你處理，例如：
    
+
    在程式碼區塊裡面， & 、 < 和 > 會自動轉成 HTML 實體，這樣的方式讓你非常容易使用 Markdown 插入範例用的 HTML 原始碼，只需要複製貼上，再加上縮排就可以了，剩下的 Markdown 都會幫你處理，例如：
    
 
 
        <div class="footer">
         &copy; 2004 Foo Corporation
@@ -437,11 +437,11 @@ end tell
 </code></pre>
 
    
 
-
    程式碼區塊中，一般的 Markdown 語法不會被轉換，像是星號就只會是星號，這表示你可以很容易用 Markdown 語法寫 Markdown 語法相關的文件。
    
+
    程式碼區塊中，一般的 Markdown 語法不會被轉換，像是星號便只是星號，這表示你可以很容易地以 Markdown 語法撰寫 Markdown 語法相關的文件。
    
 
 
    分隔線
    
 
-
    你可以用在一行內用三個或以上的星號、減號、底線來建立一個分隔線，行內不能有其他東西，你也可以在星號中間插入空白，下面每種寫法都可以建立分隔線：
    
+
    你可以在一行中用三個或以上的星號、減號、底線來建立一個分隔線，行內不能有其他東西。你也可以在星號中間插入空白。下面每種寫法都可以建立分隔線：
    
 
 
    * * *
 
@@ -460,7 +460,7 @@ end tell
 
 
 
-
    Markdown 支援兩種形式的連結語法： 行內 和 參考 兩種形式。
    
+
    Markdown 支援兩種形式的連結語法： 行內和參考兩種形式。
    
 
 
    不管是哪一種，連結的文字都是用 [方括號] 來標記。
    
 
@@ -485,12 +485,12 @@ title attribute.</p>
 
    See my [About](/about/) page for details.
 
    
 
-
    參考形式的連結使用另外一個方括號接在連結文字的括號後面，而在第二個方括號裡面要填入連結的辨識用的標籤：
    
+
    參考形式的連結使用另外一個方括號接在連結文字的括號後面，而在第二個方括號裡面要填入用以辨識連結的標籤：
    
 
 
    This is [an example][id] reference-style link.
 
    
 
-
    你也可以選擇性的在兩個方括號中間加上空白：
    
+
    你也可以選擇性地在兩個方括號中間加上空白：
    
 
 
    This is [an example] [id] reference-style link.
 
    
@@ -507,7 +507,7 @@ title attribute.</p>
 
  • 接著一個分號
    • 
 
  • 接著一個以上的空白或 tab
    • 
 
  • 接著連結的網址
    • 
-
  • 選擇性的接著 title 內容，可以用單引號、雙引號或是括弧包著
    • 
+
  • 選擇性地接著 title 內容，可以用單引號、雙引號或是括弧包著
    • 
 
 
 
    下面這三種連結的定義都是相同：
    
@@ -517,8 +517,7 @@ title attribute.</p>
 [foo]: http://example.com/  (Optional Title Here)
 
    
 
-
    Note: 有一個已知的問題是 Markdown.pl 1.0.1 會忽略單引號包起來的
-連結 title。
    
+
    請注意： 有一個已知的問題是 Markdown.pl 1.0.1 會忽略單引號包起來的連結 title。
    
 
 
    連結網址也可以用角括號包起來：
    
 
@@ -533,13 +532,13 @@ title attribute.</p>
 
 
    網址定義只有在產生連結的時候用到，並不會直接出現在文件之中。
    
 
-
    連結辨識標籤可以有字母、數字、空白和標點符號，但是並 不 分大小寫，因此下面兩個連結是一樣的：
    
+
    連結辨識標籤可以有字母、數字、空白和標點符號，但是並不區分大小寫，因此下面兩個連結是一樣的：
    
 
 
    [link text][a]
 [link text][A]
 
    
 
-
    預設的連結標籤 功能讓你可以省略指定連結標籤，這種情形下，連結標籤和連結文字會視為相同，要用預設連結標籤只要在連結文字後面加上一個空的角括號，如果你要讓 "Google" 連結到 google.com，你可以簡化成：
    
+
    預設的連結標籤功能讓你可以省略指定連結標籤，這種情形下，連結標籤和連結文字會視為相同，要用預設連結標籤只要在連結文字後面加上一個空的角括號，如果你要讓 "Google" 連結到 google.com，你可以簡化成：
    
 
 
    [Google][]
 
    
@@ -589,7 +588,7 @@ title="Google">Google</a> than from
 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
@@ -602,7 +601,7 @@ than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
 
 
    強調
    
 
-
    Markdown 使用星號 (*) 和底線 (_) 作為標記強調字詞的符號，被 * 或_ 包圍的字詞會被轉成用 <em> 標籤包圍，用兩個 * 或 _ 包起來的話，則會被轉成 <strong> ，例如：
    
+
    Markdown 使用星號（*）和底線（_）作為標記強調字詞的符號，被 * 或 _ 包圍的字詞會被轉成用 <em> 標籤包圍，用兩個 * 或 _ 包起來的話，則會被轉成 <strong>，例如：
    
 
 
    *single asterisks*
 
@@ -640,7 +639,7 @@ __double underscores__
 
 
    程式碼
    
 
-
    如果要標記一小段行內程式碼，你可以用反引號把它包起來 (`)，例如：
    
+
    如果要標記一小段行內程式碼，你可以用反引號把它包起來（`），例如：
    
 
 
    Use the `printf()` function.
 
    
@@ -674,7 +673,7 @@ A backtick-delimited string in a code span: `` `foo` ``
 <p>A backtick-delimited string in a code span: <code>`foo`</code></p>
 
    
 
-
    在程式碼區段內， & 和角括號都會被轉成 HTML 實體，這樣會比較容易插入 HTML 原始碼，Markdown 會把下面這段：
    
+
    在程式碼區段內，& 和角括號都會被轉成 HTML 實體，這樣會比較容易插入 HTML 原始碼，Markdown 會把下面這段：
    
 
 
    Please don't use any `<blink>` tags.
 
    
@@ -697,9 +696,9 @@ equivalent of <code>&amp;mdash;</code>.</p>
 
 
    圖片
    
 
-
    很明顯的，要設計一個 "自然" 的語法來在文字中插入圖片是很有難度的。
    
+
    很明顯地，要在純文字應用中設計一個 「自然」的語法來插入圖片是有一定難度的。
    
 
-
    Markdown 使用一種和連結很像的語法來標記圖片，同樣也允許兩種樣式： 行內 和 參考 。
    
+
    Markdown 使用一種和連結很相似的語法來標記圖片，同樣也允許兩種樣式： 行內和參考。
    
 
 
    行內圖片的語法看起來像是：
    
 
@@ -722,7 +721,7 @@ equivalent of <code>&amp;mdash;</code>.</p>
 
    ![Alt text][id]
 
    
 
-
    "id" 是圖片參考的名稱，圖片參考的定義方式則和連結參考一樣：
    
+
    「id」是圖片參考的名稱，圖片參考的定義方式則和連結參考一樣：
    
 
 
    [id]: url/to/image  "Optional title attribute"
 
    
@@ -745,7 +744,7 @@ equivalent of <code>&amp;mdash;</code>.</p>
 
    <a href="http://example.com/">http://example.com/</a>
 
    
 
-
    自動的郵件連結也很類似，只是 Markdown 會先做一個編碼轉換的過程，把文字字元轉成16進位碼的 HTML 實體，這樣的格式可以混淆一些不好的信箱位置收集機器人，例如：
    
+
    自動的郵件連結也很類似，只是 Markdown 會先做一個編碼轉換的過程，把文字字元轉成 16 進位碼的 HTML 實體，這樣的格式可以混淆一些不好的信箱地址收集機器人，例如：
    
 
 
    <address@example.com>
 
    
@@ -758,13 +757,13 @@ equivalent of <code>&amp;mdash;</code>.</p>
 &#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;</a>
    -

    在瀏覽器裡面，這段字串會變成一個可以點擊的 "address@example.com" 連結。

    +

    在瀏覽器裡面，這段字串會變成一個可以點擊的「address@example.com」連結。

    -

    （這種作法雖然可以混淆不少的機器人，但並無法全部檔下來，不過這樣也比什麼都不做還好不管如何，公開你的信箱終究是會引來廣告信件的。）

    +

    （這種作法雖然可以混淆不少的機器人，但並無法全部擋下來，不過這樣也比什麼都不做好些。無論如何，公開你的信箱終究會引來廣告信件的。）

    跳脫字元

    -

    Markdown 可以利用反斜線來插入一些在語法中有其他意義的符號，例如：如果你想要用星號加在文字旁邊的方式來做出強調效果（但是不是用 <em> 標籤），你可以在星號的前面加上反斜線：

    +

    Markdown 可以利用反斜線來插入一些在語法中有其它意義的符號，例如：如果你想要用星號加在文字旁邊的方式來做出強調效果（但不用 <em> 標籤），你可以在星號的前面加上反斜線：

    \*literal asterisks\*
    @@ -787,7 +786,7 @@ _ 底線

    感謝

    -

    感謝 leafy7382 協助翻譯， ethantw 的 漢字標準格式・CSS Reset 。

    +

    感謝 leafy7382 協助翻譯，ethantw 的漢字標準格式・CSS Reset。