Markdown 語法的目標(biāo)是:成為一種適用于網(wǎng)絡(luò)的書寫語言。
Markdown 不是想要取代 HTML,甚至也沒有要和它相近,它的語法種類很少,只對應(yīng) HTML 標(biāo)記的一小部分。Markdown 的構(gòu)想不是要使得 HTML 文檔更容易書寫。在我看來, HTML 已經(jīng)很容易寫了。Markdown 的理念是,能讓文檔更容易讀、寫和隨意改。HTML 是一種發(fā)布的格式,Markdown 是一種書寫的格式。就這樣,Markdown 的格式語法只涵蓋純文本可以涵蓋的范圍。
不在 Markdown 涵蓋范圍之內(nèi)的標(biāo)簽,都可以直接在文檔里面用 HTML 撰寫。不需要額外標(biāo)注這是 HTML 或是 Markdown;只要直接加標(biāo)簽就可以了。
要制約的只有一些 HTML 區(qū)塊元素――比如 <div>
、
<table>
、<pre>
、
<p>
等標(biāo)簽,必須在前后加上空行與其它內(nèi)容區(qū)隔開,還要求它們的開始標(biāo)簽與結(jié)尾標(biāo)簽不能用制表符或空格來縮進。Markdown 的生成器有足夠智能,不會在 HTML 區(qū)塊標(biāo)簽外加上不必要的 <p>
標(biāo)簽。
例子如下,在 Markdown 文件里加上一段 HTML 表格:
這是一個普通段落。
<table>
<tr>
<td>Foo</td>
</tr>
</table>
這是另一個普通段落。
請注意,在 HTML 區(qū)塊標(biāo)簽間的 Markdown 格式語法將不會被處理。比如,你在 HTML 區(qū)塊內(nèi)使用 Markdown 樣式的*強調(diào)*
會沒有效果。
HTML 的區(qū)段(行內(nèi))標(biāo)簽如 <span>
、
<cite>
、<del>
可以在
Markdown 的段落、列表或是標(biāo)題里隨意使用。依照個人習(xí)慣,甚至可以不用 Markdown 格式,而直接采用 HTML 標(biāo)簽來格式化。舉例說明:如果比較喜歡 HTML 的 <a>
或
<img>
標(biāo)簽,可以直接使用這些標(biāo)簽,而不用 Markdown 提供的鏈接或是圖像標(biāo)簽語法。
和處在 HTML 區(qū)塊標(biāo)簽間不同,Markdown 語法在 HTML 區(qū)段標(biāo)簽間是有效的。
更多建議: