@ -43,6 +43,7 @@ Document. Please refer to <a href="http://daringfireball.net/projects/markdown/s
< li > < a href = "#backslash" > 跳脫字元< / a > < / li > < li > < a href = "#backslash" > 跳脫字元< / a > < / li >
< li > < a href = "#autolink" > 自動連結< / a > < / li > < li > < a href = "#autolink" > 自動連結< / a > < / li >
< / ul > < / li > < / ul > < / li >
< li > < a href = "#acknowledgement" > 感謝< / a > < / li >
< / ul > < / ul >
< p > < strong > Note:< / strong > 這份文件是用 Markdown 寫的，你可以 < a href = "https://github.com/othree/markdown-syntax-zhtw/blob/master/syntax.md" > 看看他的原始檔< / a > 。< / p > < p > < strong > Note:< / strong > 這份文件是用 Markdown 寫的，你可以 < a href = "https://github.com/othree/markdown-syntax-zhtw/blob/master/syntax.md" > 看看他的原始檔< / a > 。< / p >
@ -55,35 +56,19 @@ Document. Please refer to <a href="http://daringfireball.net/projects/markdown/s
< p > Markdown 將容易閱讀和容易寫作這兩點作為主要目標。< / p > < p > Markdown 將容易閱讀和容易寫作這兩點作為主要目標。< / p >
< p > 可讀性則是其中最重要的一個特點，一篇 Markdown 格式的文件應該要可以直< p > 可讀性則是其中最重要的一個特點，一篇 Markdown 格式的文件應該要可以直接作為發佈用的文件，而不會讓人覺得他是使用像是邊簽語言之類的格式來編寫，Markdown 的文件格式受到很多的 text-to-HTML 格式的影響，包括 < a href = "http://docutils.sourceforge.net/mirror/setext.html" > Setext< / a > 、< a href = "http://www.aaronsw.com/2002/atx/" > atx< / a > 、< a href = "http://textism.com/tools/textile/" > Textile< / a > 、< a href = "http://docutils.sourceforge.net/rst.html" > reStructuredText< / a > 、< a href = "http://www.triptico.com/software/grutatxt.html" > Grutatext< / a > 和 < a href = "http://ettext.taint.org/doc/" > EtText< / a > ，然而影響最大的其實是純文字的電子郵件。< / p >
接作為發佈用的文件，而不會讓人覺得他是使用像是邊簽語言之類的格式來編
寫，Markdown 的文件格式受到很多的 text-to-HTML 格式的影響，包括
< a href = "http://docutils.sourceforge.net/mirror/setext.html" > Setext< / a > 、< a href = "http://www.aaronsw.com/2002/atx/" > atx< / a > 、< a href = "http://textism.com/tools/textile/" > Textile< / a > 、< a href = "http://docutils.sourceforge.net/rst.html" > reStructuredText< / a > 、
< a href = "http://www.triptico.com/software/grutatxt.html" > Grutatext< / a > 和 < a href = "http://ettext.taint.org/doc/" > EtText< / a > ，然而影響最大的其實是純文字的電子郵
件。< / p >
< p > 為了這個目的，Markdown 的語法全部由標點符號來組成，標點符號的選擇是依< p > 為了這個目的，Markdown 的語法全部由標點符號來組成，標點符號的選擇是依據他們看起來樣子或是他們的意義慎重的考慮的，像是在文字兩旁加上星號，看起來就很像在 *強調* 。Markdow 的清單就很像是清單，區塊引言就很像是電子郵件的引言。< / p >
據他們看起來樣子或是他們的意義慎重的考慮的，像是在文字兩旁加上星號，看
起來就很像在 *強調* 。Markdow 的清單就很像是清單，區塊引言就很像是電
子郵件的引言。< / p >
< h3 id = "html" > 行內 HTML< / h3 > < h3 id = "html" > 行內 HTML< / h3 >
< p > Markdown 的語法有個主要的目的：用來作為一種網路內容的 < em > 寫作< / em > 用語言。< / p > < p > Markdown 的語法有個主要的目的：用來作為一種網路內容的 < em > 寫作< / em > 用語言。< / p >
< p > Markdown 不是要來取代 HTML，甚至也沒有要和它相似，它的語法種類不多，< p > Markdown 不是要來取代 HTML，甚至也沒有要和它相似，它的語法種類不多，只和 HTML 的一部分有關係，重點 < em > 不是< / em > 要創造一種更容易寫作 HTML 文件的語法，我認為 HTML 已經很容易寫了，Markdown 的重點在讓文件更容易閱讀、編寫，HTML 是一種 < em > 發佈< / em > 的格式，Markdown 是一種 < em > 編寫< / em > 的格式，因此，Markdown 的格式語法只涵蓋純文字可以涵蓋的範圍。< / p >
只和 HTML 的一部分有關係，重點 < em > 不是< / em > 要創造一種更容易寫作 HTML 文件
的語法，我認為 HTML 已經很容易寫了，Markdown 的重點在讓文件更容易
閱讀、編寫，HTML 是一種 < em > 發佈< / em > 的格式，Markdown 是一種 < em > 編寫< / em > 的格式，
因此，Markdown 的格式語法只涵蓋純文字可以涵蓋的範圍。< / p >
< p > 不在 Markdown 涵蓋範圍之外的標籤，都可以直接在文件裡面用 HTML 撰寫。< p > 不在 Markdown 涵蓋範圍之外的標籤，都可以直接在文件裡面用 HTML 撰寫。不需要額外標註這是 HTML 或是 Markdown；只要直接加標籤就可以了。< / p >
不需要額外標註這是 HTML 或是 Markdown；只要直接加標籤就可以了。< / p >
< p > 只有區塊元素──比如 < code > < div> < / code > ,< code > < table> < / code > , < code > < pre> < / code > , < code > < p> < / code > 等標籤，必需在< p > 只有區塊元素──比如 < code > < div> < / code > ,< code > < table> < / code > , < code > < pre> < / code > , < code > < p> < / code > 等標籤，必需在前後加上空白，以利與內容區隔。而且這些的開始與結尾標籤，不可以用 tab 或是空白來縮排。Markdown 的產生器有智慧型判斷，可以避免在區塊標籤前後加上沒有必要的 < code > < p> < / code > 標籤。< / p >
前後加上空白，以利與內容區隔。而且這些的開始與結尾標籤，不可以用 tab
或是空白來縮排。Markdown 的產生器有智慧型判斷，可以避免在區塊標籤前後
加上沒有必要的 < code > < p> < / code > 標籤。< / p >
< p > 舉例來說，在 Markdown 文件裡加上一段 HTML 表格：< / p > < p > 舉例來說，在 Markdown 文件裡加上一段 HTML 表格：< / p >
@ -98,25 +83,17 @@ Document. Please refer to <a href="http://daringfireball.net/projects/markdown/s
This is another regular paragraph.This is another regular paragraph.
< / code > < / pre > < / code > < / pre >
< p > 請注意，在 HTML 區塊標籤內，是不會對 Markdown 的語法進行處理的。例如，< p > 請注意，在 HTML 區塊標籤內，是不會對 Markdown 的語法進行處理的。例如，HTML 區塊內，無法使用 Markdown 形式的 < code > *強調*< / code > < / p >
HTML 區塊內，無法使用 Markdown 形式的 < code > *強調*< / code > < / p >
< p > HTML 的區段標間如 < code > < span> < / code > , < code > < cite> < / code > 或者 < code > < del> < / code > 則不受限制，可以在< p > HTML 的區段標間如 < code > < span> < / code > , < code > < cite> < / code > 或者 < code > < del> < / code > 則不受限制，可以在Markdown 的段落、清單或是標題裡任意使用。依照個人習慣，甚至可以不用Markdown 格式，而採用 HTML 標籤來格式化。舉例說明：如果比較喜歡 HTML 的 < code > < a> < / code > 或 < code > < img> < / code > 標籤，可以直接使用這些標籤，而不用 Markdown 提供的連結或是影像標示語法。< / p >
Markdown 的段落、清單或是標題裡任意使用。依照個人習慣，甚至可以不用
Markdown 格式，而採用 HTML 標籤來格式化。舉例說明：如果比較喜歡 HTML
的 < code > < a> < / code > 或 < code > < img> < / code > 標籤，可以直接使用這些標籤，而不用 Markdown 提
供的連結或是影像標示語法。< / p >
< p > HTML 區段標籤和區塊標籤不同，在區段標籤的範圍內， Markdown 的語法是有效的。< / p > < p > HTML 區段標籤和區塊標籤不同，在區段標籤的範圍內， Markdown 的語法是有效的。< / p >
< h3 id = "autoescape" > 特殊字元自動轉換< / h3 > < h3 id = "autoescape" > 特殊字元自動轉換< / h3 >
< p > 在 HTML 文件中，有兩個字元需要特殊處理： < code > < < / code > 和 < code > & < / code > 。 < code > < < / code > 符號用於起始< p > 在 HTML 文件中，有兩個字元需要特殊處理： < code > < < / code > 和 < code > & < / code > 。 < code > < < / code > 符號用於起始標籤，< code > & < / code > 符號則用於標記 HTML 實體，如果你只是想要使用這些符號，你必須要使用實體的形式，像是 < code > & lt;< / code > 和 < code > & amp;< / code > 。< / p >
標籤，< code > & < / code > 符號則用於標記 HTML 實體，如果你只是想要使用這些符號，你必須要
使用實體的形式，像是 < code > & lt;< / code > 和 < code > & amp;< / code > 。< / p >
< p > < code > & < / code > 符號其實很讓寫作網路文件的人很困擾，如果你要打 'AT& T' ，你必須要寫成< p > < code > & < / code > 符號其實很讓寫作網路文件的人很困擾，如果你要打 'AT& T' ，你必須要寫成'< code > AT& amp;T< / code > ' ，你還必須要轉換網址內的 < code > & < / code > 符號，如果你要連結到：< / p >
'< code > AT& amp;T< / code > ' ，你還必須要轉換網址內的 < code > & < / code > 符號，如果你要連結到：< / p >
< pre > < code > http://images.google.com/images?num=30& q=larry+bird< pre > < code > http://images.google.com/images?num=30& q=larry+bird
< / code > < / pre > < / code > < / pre >
@ -126,14 +103,9 @@ Markdown 格式，而採用 HTML 標籤來格式化。舉例說明：如果比
< pre > < code > http://images.google.com/images?num=30& amp;q=larry+bird< pre > < code > http://images.google.com/images?num=30& amp;q=larry+bird
< / code > < / pre > < / code > < / pre >
< p > 才能放到你的連結標籤的 < code > href< / code > 裡，不用說也知道這很容易忘記，這也可能是數量最多的< p > 才能放到你的連結標籤的 < code > href< / code > 裡，不用說也知道這很容易忘記，這也可能是數量最多的HTML 標準檢查的錯誤。< / p >
HTML 標準檢查的錯誤。< / p >
< p > Markdown 允許你直接使用這些符號，但是你要小心跳脫字元的使用，如果你是在< p > Markdown 允許你直接使用這些符號，但是你要小心跳脫字元的使用，如果你是在HTML 實體中使用 < code > & < / code > 符號的話，它不會被轉換，而在其它情形下，它則會被轉換成 < code > & amp;< / code > 所以你如果要在文件中插入一個著作權的符號，你可以這樣寫：< / p >
HTML 實體中使用 < code > & < / code > 符號的話，它不會被轉換，而在其它情形下，它則會被轉換
成 < code > & amp;< / code > < / p >
< p > 所以你如果要在文件中插入一個著作權的符號，你可以這樣寫：< / p >
< pre > < code > & copy;< pre > < code > & copy;
< / code > < / pre > < / code > < / pre >
@ -148,9 +120,7 @@ HTML 實體中使用 <code>&</code> 符號的話，它不會被轉換，而
< pre > < code > AT& amp;T< pre > < code > AT& amp;T
< / code > < / pre > < / code > < / pre >
< p > 類似的狀況也會發生在 < code > < < / code > 符號上，因為 Markdown 支援 < a href = "#html" > 行內 HTML< / a > ，< p > 類似的狀況也會發生在 < code > < < / code > 符號上，因為 Markdown 支援 < a href = "#html" > 行內 HTML< / a > ，如果你是使用 < code > < < / code > 符號作為 HTML 標籤使用，那 Markdown 也不會對它做任何轉換，但是如果你是寫：< / p >
如果你是使用 < code > < < / code > 符號作為 HTML 標籤使用，那 Markdown 也不會對它做任何轉換，
但是如果你是寫：< / p >
< pre > < code > 4 < 5< pre > < code > 4 < 5
< / code > < / pre > < / code > < / pre >
@ -160,10 +130,7 @@ HTML 實體中使用 <code>&</code> 符號的話，它不會被轉換，而
< pre > < code > 4 & lt; 5< pre > < code > 4 & lt; 5
< / code > < / pre > < / code > < / pre >
< p > 不過要注意的是，code 範圍內，不論是行內還是區塊， < code > < < / code > 和 < code > & < / code > 兩個符號都 < em > 一定< / em > < p > 不過要注意的是，code 範圍內，不論是行內還是區塊， < code > < < / code > 和 < code > & < / code > 兩個符號都 < em > 一定< / em > 會被轉換成 HTML 實體，這項特性讓你可以很容易的用 Markdown 寫 HTML code （和 HTML 相對而言， HTML 語法中，你要把所有的 < code > < < / code > 和 < code > & < / code > 都轉換為 HTML 實體，你才能在 HTML 文件裡面寫出 HTML code。）< / p >
會被轉換成 HTML 實體，這項特性讓你可以很容易的用 Markdown 寫 HTML code
（和 HTML 相對而言， HTML 語法中，你要把所有的 < code > < < / code > 和 < code > & < / code > 都轉換為 HTML 實體，
你才能在 HTML 文件裡面寫出 HTML code）< / p >
< hr / > < hr / >
@ -171,26 +138,19 @@ HTML 實體中使用 <code>&</code> 符號的話，它不會被轉換，而
< h3 id = "p" > 段落和換行< / h3 > < h3 id = "p" > 段落和換行< / h3 >
< p > 一個段落是由一個以上連接的行句組成，而一個以上的空行則會切分出不同的段落< p > 一個段落是由一個以上連接的行句組成，而一個以上的空行則會切分出不同的段落（空行的定義是顯示上看起來像是空行，就被視為空行，例如有一行只有空白和 tab，那該行也會被視為空行），一般的段落不需要用空白或斷行縮排。< / p >
（空行的定義是顯示上看起來像是空行，就被視為空行，例如有一行只有空白和 tab，
那該行也會被視為空行），一般的段落不需要用空白或斷行縮排。< / p >
< p > 「一個以上連接的行句組成」這句其實暗示了 Markdow 允許段落內的強迫斷行，< p > 「一個以上連接的行句組成」這句其實暗示了 Markdow 允許段落內的強迫斷行，這個特性和其他大部分的 text-to-HTML 格式不一樣（包括 MovableType 的 "Convert Line Breaks" 選項），其它的格式會把每個斷行都轉成 < code > < br /> < / code > 標籤。< / p >
這個特性和其他大部分的 text-to-HTML 格式不一樣（包括 MovableType 的
"Convert Line Breaks" 選項），其它的格式會把每個斷行都轉成 < code > < br /> < / code > 標籤。< / p >
< p > 如果你 < em > 真的< / em > 是想要插入 < code > < br /> < / code > 標籤的話，在行尾加上兩個以上的空白，然後按 enter。< / p > < p > 如果你 < em > 真的< / em > 是想要插入 < code > < br /> < / code > 標籤的話，在行尾加上兩個以上的空白，然後按 enter。< / p >
< p > 是的，這確實讓你要花比較多功夫插入 < code > < br /> < / code > ，但是「每個換行都轉換為 < code > < br /> < / code > 」< p > 是的，這確實讓你要花比較多功夫插入 < code > < br /> < / code > ，但是「每個換行都轉換為 < code > < br /> < / code > 」的方法在 Markdown 中並不適合， Markdown 的 email 式的 < a href = "#blockquote" > 區塊引言< / a > 和多段落的< a href = "#list" > 清單< / a > 在使用換行來排版的時候，不但更好用，還更好閱讀！< / p >
的方法在 Markdown 中並不適合， Markdown 的 email 式的 < a href = "#blockquote" > 區塊引言< / a > 和多段落的
< a href = "#list" > 清單< / a > 在使用換行來排版的時候，不但更好用，還更好閱讀！< / p >
< h3 id = "header" > 標題< / h3 > < h3 id = "header" > 標題< / h3 >
< p > Markdown 支援兩種標題的語法，< a href = "http://docutils.sourceforge.net/mirror/setext.html" > Setext< / a > 和 < a href = "http://www.aaronsw.com/2002/atx/" > atx< / a > 形式。< / p > < p > Markdown 支援兩種標題的語法，< a href = "http://docutils.sourceforge.net/mirror/setext.html" > Setext< / a > 和 < a href = "http://www.aaronsw.com/2002/atx/" > atx< / a > 形式。< / p >
< p > Setext 形式是用底線的形式，利用 < code > =< / code > （最高階標題）和 < code > -< / code > （第二階標題），< p > Setext 形式是用底線的形式，利用 < code > =< / code > （最高階標題）和 < code > -< / code > （第二階標題），例如：< / p >
例如：< / p >
< pre > < code > This is an H1< pre > < code > This is an H1
==========================
@ -210,9 +170,7 @@ This is an H2
###### This is an H6###### This is an H6
< / code > < / pre > < / code > < / pre >
< p > 你可以選擇性的 "關閉" atx 樣式的標題，這純粹只是美觀用的，你如果覺得這樣< p > 你可以選擇性的 "關閉" atx 樣式的標題，這純粹只是美觀用的，你如果覺得這樣看起來比較好，就可以加上 < code > #< / code > 在行尾，而行尾的 < code > #< / code > 數量也不用和開頭一樣（行首的數量決定標題的階數）：< / p >
看起來比較好，就可以加上 < code > #< / code > 在行尾，而行尾的 < code > #< / code > 數量也不用和開頭一樣
（行首的數量決定標題的階數）：< / p >
< pre > < code > # This is an H1 #< pre > < code > # This is an H1 #
@ -223,9 +181,7 @@ This is an H2
< h3 id = "blockquote" > Blockquotes< / h3 > < h3 id = "blockquote" > Blockquotes< / h3 >
< p > Markdown 使用 email 形式的區塊引言，如果你很清楚在 email 信件中如何引言，< p > Markdown 使用 email 形式的區塊引言，如果你很清楚在 email 信件中如何引言，你就知道如何在 Markdown 文件中建立一個區塊引言，那會看起來像是你強迫斷行，然後在每行的最前面加上 < code > > < / code > ：< / p >
你就知道如何在 Markdown 文件中建立一個區塊引言，那會看起來像是你強迫斷行，
然後在每行的最前面加上 < code > > < / code > ：< / p >
< pre > < code > > This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,< pre > < code > > This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
@ -266,8 +222,7 @@ id sem consectetuer libero luctus adipiscing.
> return shell_exec("echo $input | $markdown_script");> return shell_exec("echo $input | $markdown_script");
< / code > < / pre > < / code > < / pre >
< p > 任何標準的文字編輯器都可以簡單的建立 email 樣式的引言，例如 BBEdit ，你可以< p > 任何標準的文字編輯器都可以簡單的建立 email 樣式的引言，例如 BBEdit ，你可以選取文字後然後從選單中選擇 < em > 增加引言階層< / em > 。< / p >
選取文字後然後從選單中選擇 < em > 增加引言階層< / em > 。< / p >
< h3 id = "list" > 清單< / h3 > < h3 id = "list" > 清單< / h3 >
@ -301,8 +256,7 @@ id sem consectetuer libero luctus adipiscing.
3. Parish3. Parish
< / code > < / pre > < / code > < / pre >
< p > 很重要的一點是：你的清單標記上的數字並不會影響輸出的 HTML 結果，上面< p > 很重要的一點是：你的清單標記上的數字並不會影響輸出的 HTML 結果，上面的清單所產生的 HTML 標記為：< / p >
的清單所產生的 HTML 標記為：< / p >
< pre > < code > < ol> < pre > < code > < ol>
< li> Bird< /li> < li> Bird< /li>
@ -325,14 +279,11 @@ id sem consectetuer libero luctus adipiscing.
8. Parish8. Parish
< / code > < / pre > < / code > < / pre >
< p > 你都會得到完全一樣的 HTML 輸出，重點在於，你可以讓你的 Markdown 文件的清單< p > 你都會得到完全一樣的 HTML 輸出，重點在於，你可以讓你的 Markdown 文件的清單數字和輸出的結果一樣，或是你懶一點，你可以完全不用在意數字的正確性。< / p >
數字和輸出的結果一樣，或是你懶一點，你可以完全不用在意數字的正確性。< / p >
< p > 如果你使用懶惰的寫法，建議第一個項目最好還是從 1. 開始，因為 Markdown 未來< p > 如果你使用懶惰的寫法，建議第一個項目最好還是從 1. 開始，因為 Markdown 未來可能會支援有序清單的 start 屬性。< / p >
可能會支援有序清單的 start 屬性。< / p >
< p > 清單項目標記通常是放在最左邊，但是其實也可以縮排，最多三個空白，項目標記後面< p > 清單項目標記通常是放在最左邊，但是其實也可以縮排，最多三個空白，項目標記後面則一定要接著至少一個空白或 tab。< / p >
則一定要接著至少一個空白或 tab。< / p >
< p > 要讓清單看起來更漂亮，你可以把內容用固定的縮排整理好：< / p > < p > 要讓清單看起來更漂亮，你可以把內容用固定的縮排整理好：< / p >
@ -382,8 +333,7 @@ Suspendisse id sem consectetuer libero luctus adipiscing.
< /ul> < /ul>
< / code > < / pre > < / code > < / pre >
< p > 清單項目可以包含多個段落，每個項目下的端落都必須要縮排 4 個空白或< p > 清單項目可以包含多個段落，每個項目下的端落都必須要縮排 4 個空白或是一個 tab ：< / p >
是一個 tab ：< / p >
< pre > < code > 1. This is a list item with two paragraphs. Lorem ipsum dolor< pre > < code > 1. This is a list item with two paragraphs. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit. Aliquam hendrerit sit amet, consectetuer adipiscing elit. Aliquam hendrerit
@ -396,8 +346,7 @@ Suspendisse id sem consectetuer libero luctus adipiscing.
2. Suspendisse id sem consectetuer libero luctus adipiscing.2. Suspendisse id sem consectetuer libero luctus adipiscing.
< / code > < / pre > < / code > < / pre >
< p > 如果你每行都有縮排，看起來會看好很多，當然，再次的，如果你很懶惰，< p > 如果你每行都有縮排，看起來會看好很多，當然，再次的，如果你很懶惰，Markdown 也允許：< / p >
Markdown 也允許：< / p >
< pre > < code > * This is a list item with two paragraphs.< pre > < code > * This is a list item with two paragraphs.
@ -416,8 +365,7 @@ sit amet, consectetuer adipiscing elit.
> inside a list item. > inside a list item.
< / code > < / pre > < / code > < / pre >
< p > 如果要放程式碼區塊的話，該區塊就需要縮排 < em > 兩次< / em > ，也就是 8 個< p > 如果要放程式碼區塊的話，該區塊就需要縮排 < em > 兩次< / em > ，也就是 8 個空白或是兩個 tab：< / p >
空白或是兩個 tab：< / p >
< pre > < code > * A list item with a code block:< pre > < code > * A list item with a code block:
@ -429,20 +377,16 @@ sit amet, consectetuer adipiscing elit.
< pre > < code > 1986. What a great season.< pre > < code > 1986. What a great season.
< / code > < / pre > < / code > < / pre >
< p > 換句話說，也就是在行首出現 < em > 數字-句點-空白< / em > ，要避免這樣的狀況，你< p > 換句話說，也就是在行首出現 < em > 數字-句點-空白< / em > ，要避免這樣的狀況，你可以在句點前面加上反斜線。< / p >
可以在句點前面加上反斜線。< / p >
< pre > < code > 1986\. What a great season.< pre > < code > 1986\. What a great season.
< / code > < / pre > < / code > < / pre >
< h3 id = "precode" > 程式碼區塊< / h3 > < h3 id = "precode" > 程式碼區塊< / h3 >
< p > 和程式相關的寫作或是標籤語言原始碼通常會有已經排版好的程式碼區塊，通常這些< p > 和程式相關的寫作或是標籤語言原始碼通常會有已經排版好的程式碼區塊，通常這些區塊我們並不希望它照一般段落文件的方式去排版，而是照原來的樣子顯示，Markdown 會用 < code > < pre> < / code > 和 < code > < code> < / code > 標籤來把程式碼區塊包起來。< / p >
區塊我們並不希望它照一般段落文件的方式去排版，而是照原來的樣子顯示，Markdown
會用 < code > < pre> < / code > 和 < code > < code> < / code > 標籤來把程式碼區塊包起來。< / p >
< p > 在 Markdown 中要建立程式碼區塊很簡單，只要簡單的縮排 4 個空白或是 1 個 tab 就可以，< p > 在 Markdown 中要建立程式碼區塊很簡單，只要簡單的縮排 4 個空白或是 1 個 tab 就可以，例如，下面的輸入：< / p >
例如，下面的輸入：< / p >
< pre > < code > This is a normal paragraph:< pre > < code > This is a normal paragraph:
@ -478,9 +422,7 @@ end tell
< p > 一個程式碼區塊會一直持續到碰到沒有縮排的行（或是文件結尾）。< / p > < p > 一個程式碼區塊會一直持續到碰到沒有縮排的行（或是文件結尾）。< / p >
< p > 在程式碼區塊裡面， < code > & < / code > 、 < code > < < / code > 和 < code > > < / code > 會自動轉成 HTML 實體，這樣的方式會讓< p > 在程式碼區塊裡面， < code > & < / code > 、 < code > < < / code > 和 < code > > < / code > 會自動轉成 HTML 實體，這樣的方式會讓你非常容易使用 Markdown 插入範例用的 HTML 原始碼，只需要複製貼上，然後縮排就可以了，剩下的 Markdown 都會幫你處理，例如：< / p >
你非常容易使用 Markdown 插入範例用的 HTML 原始碼，只需要複製貼上，然後縮
排就可以了，剩下的 Markdown 都會幫你處理，例如：< / p >
< pre > < code > < div class="footer"> < pre > < code > < div class="footer">
& copy; 2004 Foo Corporation & copy; 2004 Foo Corporation
@ -495,14 +437,11 @@ end tell
< /code> < /pre> < /code> < /pre>
< / code > < / pre > < / code > < / pre >
< p > 程式碼區塊中，一般的 Markdown 語法不會被轉換，像是星號就只會是星號，< p > 程式碼區塊中，一般的 Markdown 語法不會被轉換，像是星號就只會是星號，這表示你可以很容易用 Markdown 語法寫 Markdown 語法相關的文件。< / p >
這表示你可以很容易用 Markdown 語法寫 Markdown 語法相關的文件。< / p >
< h3 id = "hr" > 分隔線< / h3 > < h3 id = "hr" > 分隔線< / h3 >
< p > 你可以用在一行內用三個或以上的星號、減號、底線來建立一個分隔線，< p > 你可以用在一行內用三個或以上的星號、減號、底線來建立一個分隔線，行內不能有其他東西，你也可以在星號中間插入空白，下面每種寫法都可以建立分隔線：< / p >
行內不能有其他東西，你也可以在星號中間插入空白，下面每種寫法都可
以建立分隔線：< / p >
< pre > < code > * * *< pre > < code > * * *
@ -525,9 +464,7 @@ end tell
< p > 不管是哪一種，連結的文字都是用 [方括號] 來標記。< / p > < p > 不管是哪一種，連結的文字都是用 [方括號] 來標記。< / p >
< p > 要建立一個行內形式的連結，只要在方塊括號後面馬上接著括號並插入網址連結即可，< p > 要建立一個行內形式的連結，只要在方塊括號後面馬上接著括號並插入網址連結即可，如果你還想要加上連結的 title 文字，只要在網址後面，用雙引號把 title 文字包起來即可，例如：< / p >
如果你還想要加上連結的 title 文字，只要在網址後面，用雙引號把 title 文字
包起來即可，例如：< / p >
< pre > < code > This is [an example](http://example.com/ "Title") inline link.< pre > < code > This is [an example](http://example.com/ "Title") inline link.
@ -548,8 +485,7 @@ title attribute.</p>
< pre > < code > See my [About](/about/) page for details.< pre > < code > See my [About](/about/) page for details.
< / code > < / pre > < / code > < / pre >
< p > 參考形式的連結使用另外一個方括號接在連結文字的括號後面，而在第二個方括號< p > 參考形式的連結使用另外一個方括號接在連結文字的括號後面，而在第二個方括號裡面要填入連結的辨識用的標籤：< / p >
裡面要填入連結的辨識用的標籤：< / p >
< pre > < code > This is [an example][id] reference-style link.< pre > < code > This is [an example][id] reference-style link.
< / code > < / pre > < / code > < / pre >
@ -589,8 +525,7 @@ title attribute.</p>
< pre > < code > [id]: < http://example.com/> "Optional Title Here"< pre > < code > [id]: < http://example.com/> "Optional Title Here"
< / code > < / pre > < / code > < / pre >
< p > 你也可以把 title 屬性放到下一行，也可以加一些縮排，網址太長的話，這樣< p > 你也可以把 title 屬性放到下一行，也可以加一些縮排，網址太長的話，這樣會比較好看：< / p >
會比較好看：< / p >
< pre > < code > [id]: http://example.com/longish/path/to/resource/here< pre > < code > [id]: http://example.com/longish/path/to/resource/here
"Optional Title Here" "Optional Title Here"
@ -598,16 +533,13 @@ title attribute.</p>
< p > 網址定義只有在產生連結的時候用到，並不會直接出現在文件之中。< / p > < p > 網址定義只有在產生連結的時候用到，並不會直接出現在文件之中。< / p >
< p > 連結辨識標籤可以有字母、數字、空白和標點符號，但是並 < em > 不< / em > 分大小寫，< p > 連結辨識標籤可以有字母、數字、空白和標點符號，但是並 < em > 不< / em > 分大小寫，因此下面兩個連結是一樣的：< / p >
因此下面兩個連結是一樣的：< / p >
< pre > < code > [link text][a]< pre > < code > [link text][a]
[link text][A][link text][A]
< / code > < / pre > < / code > < / pre >
< p > < em > 預設的連結標籤< / em > 功能讓你可以省略指定連結標籤，這種情形下，連結標籤< p > < em > 預設的連結標籤< / em > 功能讓你可以省略指定連結標籤，這種情形下，連結標籤和連結文字會視為相同，要用預設連結標籤只要在連結文字後面加上一個空的角括號，如果你要讓 "Google" 連結到 google.com，你可以簡化成：< / p >
和連結文字會視為相同，要用預設連結標籤只要在連結文字後面加上一個空的
角括號，如果你要讓 "Google" 連結到 google.com，你可以簡化成：< / p >
< pre > < code > [Google][]< pre > < code > [Google][]
< / code > < / pre > < / code > < / pre >
@ -627,8 +559,7 @@ title attribute.</p>
< pre > < code > [Daring Fireball]: http://daringfireball.net/< pre > < code > [Daring Fireball]: http://daringfireball.net/
< / code > < / pre > < / code > < / pre >
< p > 連結的定義可以放在文件中的任何一個地方，我比較偏好直接放在連結出現< p > 連結的定義可以放在文件中的任何一個地方，我比較偏好直接放在連結出現段落的後面，你也可以把它放在文件最後面，就像是註解一樣。< / p >
段落的後面，你也可以把它放在文件最後面，就像是註解一樣。< / p >
< p > 下面是一個參考式連結的範例：< / p > < p > 下面是一個參考式連結的範例：< / p >
@ -665,19 +596,13 @@ than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").[MSN](http://search.msn.com/ "MSN Search").
< / code > < / pre > < / code > < / pre >
< p > 參考式的連結其實重點不在於它比較好寫，而是它比較好讀，比較一下上面的範例，< p > 參考式的連結其實重點不在於它比較好寫，而是它比較好讀，比較一下上面的範例，使用參考式的文章本身只有 81 個字元，但是用行內形式的連結卻會增加到 176 個字元，如果是用純 HTML 格式來寫，會有 234 個字元，在 HTML 格式中，標籤比文字還要多。< / p >
使用參考式的文章本身只有 81 個字元，但是用行內形式的連結卻會增加到 176 個字元，
如果是用純 HTML 格式來寫，會有 234 個字元，在 HTML 格式中，標籤比文字還要多。< / p >
< p > 使用 Markdown 的參考式連結，可以讓文件更像是瀏覽器最後產生的結果，< p > 使用 Markdown 的參考式連結，可以讓文件更像是瀏覽器最後產生的結果，讓你可以把一些標記相關的資訊移到段落文字之外，你就可以增加連結而不讓文章的閱讀感覺被打斷。< / p >
讓你可以把一些標記相關的資訊移到段落文字之外，你就可以增加連結而不
讓文章的閱讀感覺被打斷。< / p >
< h3 id = "em" > 強調< / h3 > < h3 id = "em" > 強調< / h3 >
< p > Markdown 使用星號 (< code > *< / code > ) 和底線 (< code > _< / code > ) 作為標記強調字詞的符號，被 < code > *< / code > 或< p > Markdown 使用星號 (< code > *< / code > ) 和底線 (< code > _< / code > ) 作為標記強調字詞的符號，被 < code > *< / code > 或< code > _< / code > 包圍的字詞會被轉成用 < code > < em> < / code > 標籤包圍，用兩個 < code > *< / code > 或 < code > _< / code > 包起來的話，則會被轉成 < code > < strong> < / code > ，例如：< / p >
< code > _< / code > 包圍的字詞會被轉成用 < code > < em> < / code > 標籤包圍，用兩個 < code > *< / code > 或 < code > _< / code > 包起來的話，
則會被轉成 < code > < strong> < / code > ，例如：< / p >
< pre > < code > *single asterisks*< pre > < code > *single asterisks*
@ -699,8 +624,7 @@ __double underscores__
< strong> double underscores< /strong> < strong> double underscores< /strong>
< / code > < / pre > < / code > < / pre >
< p > 你可以隨便用你喜歡的樣式，唯一的限制是，你用什麼符號開啟標籤，就要< p > 你可以隨便用你喜歡的樣式，唯一的限制是，你用什麼符號開啟標籤，就要用什麼符號結束。< / p >
用什麼符號結束。< / p >
< p > 強調也可以直接差在文字中間：< / p > < p > 強調也可以直接差在文字中間：< / p >
@ -736,8 +660,7 @@ __double underscores__
< pre > < code > < p> < code> There is a literal backtick (`) here.< /code> < /p> < pre > < code > < p> < code> There is a literal backtick (`) here.< /code> < /p>
< / code > < / pre > < / code > < / pre >
< p > 程式碼區段的起始和結束端都可以放入一個空白，起始端後面一個，結束端前面一個，< p > 程式碼區段的起始和結束端都可以放入一個空白，起始端後面一個，結束端前面一個，這樣你就可以在區段的一開始就插入反引號：< / p >
這樣你就可以在區段的一開始就插入反引號：< / p >
< pre > < code > A single backtick in a code span: `` ` ``< pre > < code > A single backtick in a code span: `` ` ``
@ -751,8 +674,7 @@ A backtick-delimited string in a code span: `` `foo` ``
< p> A backtick-delimited string in a code span: < code> `foo`< /code> < /p> < p> A backtick-delimited string in a code span: < code> `foo`< /code> < /p>
< / code > < / pre > < / code > < / pre >
< p > 在程式碼區段內， < code > & < / code > 和角括號都會被轉成 HTML 實體，這樣會比較容易插入 HTML 原始碼，< p > 在程式碼區段內， < code > & < / code > 和角括號都會被轉成 HTML 實體，這樣會比較容易插入 HTML 原始碼，Markdown 會把下面這段：< / p >
Markdown 會把下面這段：< / p >
< pre > < code > Please don't use any `< blink> ` tags.< pre > < code > Please don't use any `< blink> ` tags.
< / code > < / pre > < / code > < / pre >
@ -805,8 +727,7 @@ equivalent of <code>&amp;mdash;</code>.</p>
< pre > < code > [id]: url/to/image "Optional title attribute"< pre > < code > [id]: url/to/image "Optional title attribute"
< / code > < / pre > < / code > < / pre >
< p > 到目前為止， Markdown 還沒有辦法指定圖片的寬高，如果你需要的話，< p > 到目前為止， Markdown 還沒有辦法指定圖片的寬高，如果你需要的話，你可以使用普通的 < code > < img> < / code > 標籤。< / p >
你可以使用普通的 < code > < img> < / code > 標籤。< / p >
< hr / > < hr / >
@ -814,9 +735,7 @@ equivalent of <code>&amp;mdash;</code>.</p>
< h3 id = "autolink" > 自動連結< / h3 > < h3 id = "autolink" > 自動連結< / h3 >
< p > Markdown 支援比較簡短的自動連結形式來處理網址和電子郵件信箱，< p > Markdown 支援比較簡短的自動連結形式來處理網址和電子郵件信箱，只要是用角括號包起來， Markdown 就會自動把它轉成連結，連結的文字就和連結位置一樣，例如：< / p >
只要是用角括號包起來， Markdown 就會自動把它轉成連結，連結的文字
就和連結位置一樣，例如：< / p >
< pre > < code > < http://example.com/> < pre > < code > < http://example.com/>
< / code > < / pre > < / code > < / pre >
@ -826,9 +745,7 @@ equivalent of <code>&amp;mdash;</code>.</p>
< pre > < code > < a href="http://example.com/"> http://example.com/< /a> < pre > < code > < a href="http://example.com/"> http://example.com/< /a>
< / code > < / pre > < / code > < / pre >
< p > 自動的郵件連結也很類似，只是 Markdown 會先做一個編碼轉換的過程，< p > 自動的郵件連結也很類似，只是 Markdown 會先做一個編碼轉換的過程，把文字字元轉成16進位碼的 HTML 實體，這樣的格式可以混淆一些不好的信箱位置收集機器人，例如：< / p >
把文字字元轉成16進位碼的 HTML 實體，這樣的格式可以混淆一些不好的
信箱位置收集機器人，例如：< / p >
< pre > < code > < address@example.com> < pre > < code > < address@example.com>
< / code > < / pre > < / code > < / pre >
@ -843,14 +760,11 @@ equivalent of <code>&amp;mdash;</code>.</p>
< p > 在瀏覽器裡面，這段字串會變成一個可以點擊的 "address@example.com" 連結。< / p > < p > 在瀏覽器裡面，這段字串會變成一個可以點擊的 "address@example.com" 連結。< / p >
< p > （這種作法雖然可以混淆不少的機器人，但並無法全部檔下來，不過這樣也比什麼都不做還好< p > （這種作法雖然可以混淆不少的機器人，但並無法全部檔下來，不過這樣也比什麼都不做還好不管如何，公開你的信箱終究是會引來廣告信件的。）< / p >
不管如何，公開你的信箱終究是會引來廣告信件的。）< / p >
< h3 id = "backslash" > 跳脫字元< / h3 > < h3 id = "backslash" > 跳脫字元< / h3 >
< p > Markdown 可以利用反斜線來插入一些在語法中有其他意義的符號，例如：< p > Markdown 可以利用反斜線來插入一些在語法中有其他意義的符號，例如：如果你想要用星號加在文字旁邊的方式來做出強調效果（但是不是用 < code > < em> < / code > 標籤），你可以在星號的前面加上反斜線：< / p >
如果你想要用星號加在文字旁邊的方式來做出強調效果（但是不是用 < code > < em> < / code > 標籤），
你可以在星號的前面加上反斜線：< / p >
< pre > < code > \*literal asterisks\*< pre > < code > \*literal asterisks\*
< / code > < / pre > < / code > < / pre >
@ -871,6 +785,10 @@ _ 底線
! 驚嘆號! 驚嘆號
< / code > < / pre > < / code > < / pre >
< h2 id = "acknowledgement" > 感謝< / h2 >
< p > 感謝 < a href = "https://twitter.com/#!/leafy7382" > leafy7382< / a > 協助翻譯， < a href = "https://twitter.com/#!/ethantw" > ethantw< / a > 的 < a href = "http://ethantw.net/projects/han/" > 漢字標準格式・CSS Reset< / a > 。< / p >
< / div > < / div >
< script type = "text/javascript" > < script type = "text/javascript" >
othree
14 years ago