资源说明:Markdown 語法說明中文版
Markdown文件 ================== ![](https://markdown.tw/images/208x128.png) **NOTE:** This is Traditional Chinese Edition Document of Markdown Syntax. If you are seeking for English Edition Document. Please refer to [Markdown: Syntax][eng-doc]. [eng-doc]:http://daringfireball.net/projects/markdown/syntax Markdown: Syntax ================ * [概述](#overview) * [哲學](#philosophy) * [行內 HTML](#html) * [特殊字元自動轉換](#autoescape) * [區塊元素](#block) * [段落和換行](#p) * [標題](#header) * [區塊引言](#blockquote) * [清單](#list) * [程式碼區塊](#precode) * [分隔線](#hr) * [區段元素](#span) * [連結](#link) * [強調](#em) * [程式碼](#code) * [圖片](#img) * [其他](#misc) * [跳脫字元](#backslash) * [自動連結](#autolink) * [感謝](#acknowledgement) **注意:**這份文件是用Markdown寫的,你可以[看看它的原始檔][src] 。 [src]: https://github.com/othree/markdown-syntax-zhtw/blob/master/syntax.md * * *概述
哲學
Markdown的目標是實現「易讀易寫」。 不過最需要強調的便是它的可讀性。一份使用Markdown格式撰寫的文件應該可以直接以純文字發佈,並且看起來不會像是由許多標籤或是格式指令所構成。Markdown語法受到一些既有text-to-HTML格式的影響,包括[Setext][1]、[atx][2]、[Textile][3]、[reStructuredText][4]、[Grutatext][5] 和 [EtText][6],然而最大靈感來源其實是純文字的電子郵件格式。 [1]: http://docutils.sourceforge.net/mirror/setext.html [2]: http://www.aaronsw.com/2002/atx/ [3]: http://textism.com/tools/textile/ [4]: http://docutils.sourceforge.net/rst.html [5]: http://www.triptico.com/software/grutatxt.html [6]: http://ettext.taint.org/doc/ 因此Markdown的語法全由標點符號所組成,並經過嚴謹慎選,是為了讓它們看起來就像所要表達的意思。像是在文字兩旁加上星號,看起來就像\*強調\*。Markdown的清單看起來,嗯,就是清單。假如你有使用過電子郵件,區塊引言看起來就真的像是引用一段文字。行內HTML
Markdown的語法有個主要的目的:用來作為一種網路內容的*寫作*用語言。 Markdown不是要來取代HTML,甚至也沒有要和它相似,它的語法種類不多,只和HTML的一部分有關係,重點*不是*要創造一種更容易寫作HTML文件的語法,我認為HTML已經很容易寫了,Markdow的重點在於,它能讓文件更容易閱讀、編寫。HTML 是一種*發佈*的格式,Markdown是一種*編寫*的格式,因此,Markdown的格式語法只涵蓋純文字可以涵蓋的範圍。 不在Markdown涵蓋範圍之外的標籤,都可以直接在文件裡面用HTML撰寫。不需要額外標註這是HTML或是Markdown;只要直接加標籤就可以了。 只有區塊元素──比如``、`