@ -1,14 +1,14 @@
<!DOCTYPE html> <!DOCTYPE html>
< html lang = "zh-TW" > < html lang = "zh-TW" class = "han-biaodian-pro-cns han-la" >
< head > < head >
< meta charset = "UTF-8" > < meta charset = "UTF-8" >
< title > Markdown 語法說明< / title > < title > Markdown 語法說明< / title >
< link rel = "stylesheet" media = "all" href = "Han/han.mi n.css" > < link rel = "stylesheet" media = "all" href = "stylesheets/ha n.css" >
< link rel = "stylesheet" media = "all" href = "stylesheets/main.css" > < link rel = "stylesheet" media = "all" href = "stylesheets/main.css" >
< meta property = "og:title" content = "Markdown 語法說明" / > < meta property = "og:title" content = "Markdown 語法說明" / >
< meta property = "og:url" content = "http://markdown.tw/" / > < meta property = "og:url" content = "http://markdown.tw/" / >
< meta property = "og:type" content = "website" / > < meta property = "og:type" content = "website" / >
< meta property = "og:description" content = "Markdown 是很簡單的純文件格式，由於語法設計的好，近幾年廣泛應用在各種領域，包括 Github、Stacko verflow 等知名的網路服務都使用它，本網頁為該語法的中文說明" / > < meta property = "og:description" content = "Markdown 是很簡單的純文件格式，由於語法設計得好，近幾年廣泛應用在各種領域，包括 Github、Stack O verflow 等知名的網路服務都使用它，本網頁為該語法的中文說明" / >
< meta property = "og:image" content = "http://markdown.tw/images/208x128.png" / > < meta property = "og:image" content = "http://markdown.tw/images/208x128.png" / >
< meta property = "og:image:width" content = "208" / > < meta property = "og:image:width" content = "208" / >
< meta property = "og:image:height" content = "128" / > < meta property = "og:image:height" content = "128" / >
@ -19,13 +19,14 @@
< a href = "/resources.html" > 資源< / a > < a href = "/resources.html" > 資源< / a >
< a href = "https://github.com/othree/markdown-syntax-zhtw/issues" > 回報錯誤< / a > < a href = "https://github.com/othree/markdown-syntax-zhtw/issues" > 回報錯誤< / a >
< / nav > < / nav >
< div class = "wikistyle" > < div class = "wikistyle" >
< h1 > Markdown文件< / h1 > < h1 > Markdown文件< / h1 >
< p > < img src = "http://markdown.tw/images/208x128.png" alt = "Markdown" title = "" / > < / p > < p > < img src = "http://markdown.tw/images/208x128.png" alt = "Markdown" title = "" / > < / p >
< p > < strong > NOTE:< / strong > This is Traditional Chinese Edition Document of< p lang = "en" > < strong > NOTE:< / strong > This is Traditional Chinese Edition Document of
Markdown Syntax. If you are seeking for English Edition Markdown Syntax. If you are seeking for English Edition
Document. Please refer to < a href = "http://daringfireball.net/projects/markdown/syntax" > Markdown: Syntax< / a > .< / p > Document. Please refer to < a href = "http://daringfireball.net/projects/markdown/syntax" > Markdown: Syntax< / a > .< / p >
@ -54,7 +55,7 @@ Document. Please refer to <a href="http://daringfireball.net/projects/markdown/s
< li > < a href = "#code" > 程式碼< / a > < / li > < li > < a href = "#code" > 程式碼< / a > < / li >
< li > < a href = "#img" > 圖片< / a > < / li > < li > < a href = "#img" > 圖片< / a > < / li >
< / ul > < / li > < / ul > < / li >
< li > < a href = "#misc" > 其它 < / a > < li > < a href = "#misc" > 其他 < / a >
< ul > < ul >
< li > < a href = "#backslash" > 跳脫字元< / a > < / li > < li > < a href = "#backslash" > 跳脫字元< / a > < / li >
< li > < a href = "#autolink" > 自動連結< / a > < / li > < li > < a href = "#autolink" > 自動連結< / a > < / li >
@ -82,9 +83,9 @@ Document. Please refer to <a href="http://daringfireball.net/projects/markdown/s
< p > Markdown不是要來取代HTML，甚至也沒有要和它相似，它的語法種類不多，只和HTML的一部分有關係，重點< em > 不是< / em > 要創造一種更容易寫作 HTML文件的語法，我認為HTML已經很容易寫了，Markdown的重點在於，它能讓文件更容易閱讀、編寫。HTML是一種< em > 發佈< / em > 的格式，Markdown是一種< em > 編寫< / em > 的格式，因此，Markdown的格式語法只涵蓋純文字可以涵蓋的範圍。< / p > < p > Markdown不是要來取代HTML，甚至也沒有要和它相似，它的語法種類不多，只和HTML的一部分有關係，重點< em > 不是< / em > 要創造一種更容易寫作 HTML文件的語法，我認為HTML已經很容易寫了，Markdown的重點在於，它能讓文件更容易閱讀、編寫。HTML是一種< em > 發佈< / em > 的格式，Markdown是一種< em > 編寫< / em > 的格式，因此，Markdown的格式語法只涵蓋純文字可以涵蓋的範圍。< / p >
< p > 不在 Markdown 涵蓋範圍之外的標籤，都可以直接在文件裡面用 HTML 撰寫。不需要額外標註這是 HTML 或是 Markdown； 只要直接加標籤就可以了。< / p > < p > 不在Markdown涵蓋範圍之外的標籤，都可以直接在文件裡面用HTML撰寫。不需要額外標註這是HTML或是Markdown—— 只要直接加標籤就可以了。< / p >
< p > 只有區塊元素──比如 < code > < div> < / code > 、< code > < table> < / code > 、< code > < pre> < / code > 、< code > < p> < / code > 等標籤， 必需在前後加上空行，以利與內容區隔。而且這些（ 元素） 的開始與結尾標籤，不可以用 tab 或是空白來縮排。Markdown 的產生器有智慧型判斷，可以避免在區塊標籤前後加上沒有必要的 < code > < p> < / code > 標籤。< / p > < p > 只有區塊元素——比如 < code > < div> < / code > 、< code > < table> < / code > 、< code > < pre> < / code > 、< code > < p> < / code > 等標籤—— 必需在前後加上空行，以利與內容區隔。而且這些元素的開始與結尾標籤，不可以用tab或是空白來縮排。Markdown的產生器有智慧型判斷，可以避免在區塊標籤前後加上沒有必要的< code > < p> < / code > 標籤。< / p >
< p > 舉例來說，在Markdown文件裡加上一段HTML表格：< / p > < p > 舉例來說，在Markdown文件裡加上一段HTML表格：< / p >
@ -121,7 +122,7 @@ This is another regular paragraph.
< p > 才能放到連結標籤的< code > href< / code > 屬性裡。不用說也知道這很容易忘記，這也可能是HTML標準檢查所檢查到的錯誤中，數量最多的。< / p > < p > 才能放到連結標籤的< code > href< / code > 屬性裡。不用說也知道這很容易忘記，這也可能是HTML標準檢查所檢查到的錯誤中，數量最多的。< / p >
< p > Markdown 允許你直接使用這些符號，但是你要小心跳脫字元的使用，如果你是在HTML 實體中使用 < code > & < / code > 符號的話，它不會被轉換，而在其它情形下，它則會被轉換成 < code > & amp;< / code > 。所以你如果要在文件中插入一個著作權的符號，你可以這樣寫：< / p > < p > Markdown允許你直接使用這些符號，但是你要小心跳脫字元的使用，如果你是在HTML實體中使用< code > & < / code > 符號的話，它不會被轉換，而在其他情形下，它則會被轉換成 < code > & amp;< / code > 。所以你如果要在文件中插入一個著作權的符號，你可以這樣寫：< / p >
< pre > < code > & copy;< pre > < code > & copy;
< / code > < / pre > < / code > < / pre >
@ -156,7 +157,7 @@ This is another regular paragraph.
< p > 一個段落是由一個以上相連接的行句組成，而一個以上的空行則會切分出不同的段落（空行的定義是顯示上看起來像是空行，便會被視為空行。比方說，若某一行只包含空白和tab，則該行也會被視為空行），一般的段落不需要用空白或斷行縮排。< / p > < p > 一個段落是由一個以上相連接的行句組成，而一個以上的空行則會切分出不同的段落（空行的定義是顯示上看起來像是空行，便會被視為空行。比方說，若某一行只包含空白和tab，則該行也會被視為空行），一般的段落不需要用空白或斷行縮排。< / p >
< p > 「一個以上相連接的行句組成」這句話其實暗示了 Markdown 允許段落內的強迫斷行，這個特性和其他大部分的 text-to-HTML 格式不一樣（包括 MovableType 的「Convert Line Breaks」選項），其它的格式會把每個斷行都轉成 < code > < br /> < / code > 標籤。< / p > < p > 「一個以上相連接的行句組成」這句話其實暗示了Markdown允許段落內的強迫斷行，這個特性和其他大部分的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 >
@ -177,7 +178,7 @@ This is an H2
< p > 任何數量的< code > =< / code > 和< code > -< / code > 都可以有效果。< / p > < p > 任何數量的< code > =< / code > 和< code > -< / code > 都可以有效果。< / p >
< p > Atx 形式則是在行首插入 1 到 6 個 < code > #< / code > ，對應到標題 1 到 6 階，例如：< / p > < p > Atx形式則是在行首插入1至6個 < code > #< / code > ，對應到標題1到6階，例如：< / p >
< pre > < code > # This is an H1< pre > < code > # This is an H1
@ -195,7 +196,7 @@ This is an H2
### This is an H3 ######### This is an H3 ######
< / code > < / pre > < / code > < / pre >
< h3 id = "blockquote" > Blockquotes < / h3 > < h3 id = "blockquote" > 區塊引言 < / h3 >
< p > Markdown使用email形式的區塊引言，如果你很熟悉如何在email信件中引言，你就知道怎麼在Markdown文件中建立一個區塊引言，那會看起來像是你強迫斷行，然後在每行的最前面加上< code > > < / code > ：< / p > < p > Markdown使用email形式的區塊引言，如果你很熟悉如何在email信件中引言，你就知道怎麼在Markdown文件中建立一個區塊引言，那會看起來像是你強迫斷行，然後在每行的最前面加上< code > > < / code > ：< / p >
@ -297,7 +298,7 @@ id sem consectetuer libero luctus adipiscing.
< p > 你都會得到完全相同的HTML輸出。重點在於，你可以讓Markdown文件的清單數字和輸出的結果相同，或是你懶一點，你可以完全不用在意數字的正確性。< / p > < p > 你都會得到完全相同的HTML輸出。重點在於，你可以讓Markdown文件的清單數字和輸出的結果相同，或是你懶一點，你可以完全不用在意數字的正確性。< / p >
< p > 如果你使用懶惰的寫法，建議第一個項目最好還是從 1. 開始，因為 Markdown 未來可能會支援有序清單的 start 屬性。< / p > < p > 如果你使用懶惰的寫法，建議第一個項目最好還是從「1.」開始，因為Markdown未來可能會支援有序清單的start 屬性。< / p >
< p > 清單項目標記通常是放在最左邊，但是其實也可以縮排，最多三個空白，項目標記後面則一定要接著至少一個空白或tab。< / p > < p > 清單項目標記通常是放在最左邊，但是其實也可以縮排，最多三個空白，項目標記後面則一定要接著至少一個空白或tab。< / p >
@ -319,8 +320,7 @@ viverra nec, fringilla in, laoreet vitae, risus.
Suspendisse id sem consectetuer libero luctus adipiscing.Suspendisse id sem consectetuer libero luctus adipiscing.
< / code > < / pre > < / code > < / pre >
< p > 如果清單項目間用空行分開， Markdown 會把項目的內容在輸出時用 < code > < p> < / code > < p > 如果清單項目間用空行分開，Markdown會把項目的內容在輸出時用< code > < p> < / code > 標籤包起來，舉例來說：< / p >
標籤包起來，舉例來說：< / p >
< pre > < code > * Bird< pre > < code > * Bird
* Magic* Magic
@ -393,7 +393,7 @@ 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 > < p > 換句話說，也就是在行首出現< em > 數字－句點－ 空白< / em > ，要避免這樣的狀況，你可以在句點前面加上反斜線。< / p >
< pre > < code > 1986\. What a great season.< pre > < code > 1986\. What a great season.
< / code > < / pre > < / code > < / pre >
@ -417,7 +417,7 @@ sit amet, consectetuer adipiscing elit.
< /code> < /pre> < /code> < /pre>
< / code > < / pre > < / code > < / pre >
< p > 這個每行一階的縮排（4 個空白或是 1 個 tab），都會被移除，例如：< / p > < p > 這個每行一階的縮排（4個空白或是tab），都會被移除，例如：< / p >
< pre > < code > Here is an example of AppleScript:< pre > < code > Here is an example of AppleScript:
@ -478,7 +478,7 @@ end tell
< p > Markdown支援兩種形式的連結語法： < em > 行內< / em > 和< em > 參考< / em > 兩種形式。< / p > < p > Markdown支援兩種形式的連結語法： < em > 行內< / em > 和< em > 參考< / em > 兩種形式。< / p >
< p > 不管是哪一種，連結的文字都是用 [方括號] 來標記。< / p > < p > 不管是哪一種，連結的文字都是用< code > < / code > < / p >
< p > 要建立一個行內形式的連結，只要在方塊括號後面馬上接著括號並插入網址連結即可，如果你還想要加上連結的title文字，只要在網址後面，用雙引號把title文字包起來即可，例如：< / p > < p > 要建立一個行內形式的連結，只要在方塊括號後面馬上接著括號並插入網址連結即可，如果你還想要加上連結的title文字，只要在網址後面，用雙引號把title文字包起來即可，例如：< / p >
@ -554,7 +554,7 @@ title attribute.</p>
[link text][A][link text][A]
< / code > < / pre > < / code > < / pre >
< p > < em > 預設的連結標籤< / em > 功能讓你可以省略指定連結標籤，這種情形下，連結標籤和連結文字會視為相同，要用預設連結標籤只要在連結文字後面加上一個空的方括號，如果你要讓 "Google" 連結到 google.com，你可以簡化成：< / p > < p > < em > 預設的連結標籤< / em > 功能讓你可以省略指定連結標籤，這種情形下，連結標籤和連結文字會視為相同，要用預設連結標籤只要在連結文字後面加上一個空的方括號，如果你要讓「Google」連結到 google.com，你可以簡化成：< / p >
< pre > < code > [Google][]< pre > < code > [Google][]
< / code > < / pre > < / code > < / pre >
@ -728,8 +728,7 @@ equivalent of <code>&amp;mdash;</code>.</p>
< ul > < ul >
< li > 一個驚嘆號< code > !< / code > < / li > < li > 一個驚嘆號< code > !< / code > < / li >
< li > 接著一個方括號，裡面放上圖片的替代文字< / li > < li > 接著一個方括號，裡面放上圖片的替代文字< / li >
< li > 接著一個普通括號，裡面放上圖片的網址，最後還可以用引號包住並加上< li > 接著一個普通括號，裡面放上圖片的網址，最後還可以用引號包住並加上選擇性的'title'文字。< / li >
選擇性的 'title' 文字。< / li >
< / ul > < / ul >
< p > 參考式的圖片語法則長得像這樣：< / p > < p > 參考式的圖片語法則長得像這樣：< / p >
@ -746,7 +745,7 @@ equivalent of <code>&amp;mdash;</code>.</p>
< hr / > < hr / >
< h2 id = "misc" > 其它 < / h2 > < h2 id = "misc" > 其他 < / h2 >
< h3 id = "autolink" > 自動連結< / h3 > < h3 id = "autolink" > 自動連結< / h3 >
@ -779,7 +778,7 @@ equivalent of <code>&amp;mdash;</code>.</p>
< h3 id = "backslash" > 跳脫字元< / h3 > < h3 id = "backslash" > 跳脫字元< / h3 >
< p > Markdown 可以利用反斜線來插入一些在語法中有其它 意義的符號，例如：如果你想要用星號加在文字旁邊的方式來做出強調效果（但不用 < code > < em> < / code > 標籤），你可以在星號的前面加上反斜線：< / p > < p > Markdown可以利用反斜線來插入一些在語法中有其他 意義的符號，例如：如果你想要用星號加在文字旁邊的方式來做出強調效果（但不用< code > < em> < / code > 標籤），你可以在星號的前面加上反斜線：< / p >
< pre > < code > \*literal asterisks\*< pre > < code > \*literal asterisks\*
< / code > < / pre > < / code > < / pre >
@ -802,10 +801,10 @@ _ 底線
< h2 id = "acknowledgement" > 感謝< / h2 > < h2 id = "acknowledgement" > 感謝< / h2 >
< p > 感謝 < a href = "https://twitter.com/#!/leafy7382" > leafy7382< / a > 協助翻譯，< a href = "http://iamhlb.com/" > hlb< / a > 、< a href = "http://twitter.com/randylien" > Randylien< / a > 幫忙潤稿，< a href = "https://twitter.com/#!/ethantw" > ethantw< / a > 的< a href = "http://ethantw.net/projects/han /" > 漢字標準格式・CSS Reset < / a > ， < a href = "http://kidwm.net/" > WM< / a > 回報文字錯誤。< / p > < p > 感謝< a href = "https://twitter.com/#!/leafy7382" > leafy7382< / a > 協助翻譯，< a href = "http://iamhlb.com/" > hlb< / a > 、< a href = "http://twitter.com/randylien" > Randylien< / a > 幫忙潤稿，< a href = "https://twitter.com/#!/ethantw" > ethantw< / a > 的< a href = "http://css.hanzi.co /" > 漢字標準格式< / a > （Han.css） ，< a href = "http://kidwm.net/" > WM< / a > 回報文字錯誤。< / p >
< / div > < / div > <!-- /div.wikistyle -->
< div id = "comments" > < div id = "comments" >
@ -829,8 +828,7 @@ _ 底線
< / div > < / div >
< script type = "text/javascript" > < script >
var _gaq = _gaq || []; var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-21880461-1']); _gaq.push(['_setAccount', 'UA-21880461-1']);
_gaq.push(['_trackPageview']); _gaq.push(['_trackPageview']);
@ -840,9 +838,8 @@ _ 底線
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})(); })();
< / script > < / script >
< script src = "http://ajax.googleapis.com/ajax/libs/jquery/1.5/jquery.min.js > < / script > < script src = "/js/jquery-2.0.3.min.js" > < / script >
< script src = "Han/han.mi n.js" > < / script > < script src = "js/ha n.js" > < / script >
< / body > < / body >
< / html > < / html >
othree_kao
11 years ago