Markdown 語法
之劍 2016.5.3 23:41:46
<div id="category"></div>
<link rel="stylesheet" >
<script src="http://code.jquery.com/jquery-1.7.2.min.js"></script>
<script src="http://yandex.st/highlightjs/6.2/highlight.min.js"></script>
<script>hljs.initHighlightingOnLoad();</script>
<script type="text/javascript">
$(document).ready(function(){
$("h2,h3,h4,h5,h6").each(function(i,item){
var tag = $(item).get(0).localName;
$(item).attr("id","wow"+i);
$("#category").append('<a class="new'+tag+'" href="#wow'+i+'">'+$(this).text()+'</a></br>');
$(".newh2").css("margin-left",0);
$(".newh3").css("margin-left",20);
$(".newh4").css("margin-left",40);
$(".newh5").css("margin-left",60);
$(".newh6").css("margin-left",80);
});
});
</script>
概述
Markdown宗旨
Markdown 的目標是實現(xiàn)「易讀易寫」。
可讀性，無論如何，都是最重要的。一份使用 Markdown 格式撰寫的文件應該可以直接以純文本發(fā)布，并且看起來不會像是由許多標簽或是格式指令所構成。Markdown 語法受到一些既有 text-to-HTML 格式的影響，包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText，而最大靈感來源其實是純文本電子郵件的格式。
總之， Markdown 的語法全由一些符號所組成，這些符號經(jīng)過精挑細選，其作用一目了然。比如：在文字兩旁加上星號，看起來就像*強調(diào)*。Markdown 的列表看起來，嗯，就是列表。Markdown 的區(qū)塊引用看起來就真的像是引用一段文字，就像你曾在電子郵件中見過的那樣。
Markdown自動生成目錄
只要在你的文檔開頭貼上如下一段md文本即可(原樣復制):
<div id="category"></div>
<link rel="stylesheet" >
<script src="http://code.jquery.com/jquery-1.7.2.min.js"></script>
<script src="http://yandex.st/highlightjs/6.2/highlight.min.js"></script>
<script>hljs.initHighlightingOnLoad();</script>
<script type="text/javascript">
$(document).ready(function(){
$("h2,h3,h4,h5,h6").each(function(i,item){
var tag = $(item).get(0).localName;
$(item).attr("id","wow"+i);
$("#category").append('<a class="new'+tag+'" href="#wow'+i+'">'+$(this).text()+'</a></br>');
$(".newh2").css("margin-left",0);
$(".newh3").css("margin-left",20);
$(".newh4").css("margin-left",40);
$(".newh5").css("margin-left",60);
$(".newh6").css("margin-left",80);
});
});
</script>
Markdown 兼容 HTML
Markdown 語法的目標是：成為一種適用于網(wǎng)絡的書寫語言。
markdown支持html大部分標簽
markdown用于便捷的書寫網(wǎng)頁內(nèi)容
Markdown 從來不是為了取代 HTML，兩者互補性遠大于替代性。而 Markdown 這么火是它解決了（不止）程序員的痛點：
- 自帶格式化/排版信息，且規(guī)則簡單友好。非程序員同學可以快速入手。
- 同時，規(guī)則直觀且確定，不用被 office 折磨的欲仙欲死（當年畢業(yè)論文排版...）。
- 對比HTML：更專注于內(nèi)容，標簽對內(nèi)容的侵入性低。
- 最大優(yōu)點：效率！！！寫md幾乎就是寫自動排版的純文本，你寫doc和HTML試試？
比如說,放一個圖片在文檔中
所謂的動態(tài)類型語言，意思就是類型的檢查是在運行時做的，比如如下代碼是不是合法的要到運行時才判斷（注意是運行時的類型判斷）：
<img src="http://static.oschina.net/uploads/img/201412/23070943_OfhR.jpg">
def sum(a, b):
return a + b
Markdown 并不是想取代 HTML的地位，甚至接近它。它的語法種類很少，只對應 HTML 標記的一小部分。Markdown 的構想不是要使得 HTML 文檔更容易書寫。在我看來， HTML 已經(jīng)很容易寫了。Markdown 的理念是，能讓文檔更容易讀、寫和隨意改。HTML 是一種發(fā)布的格式，Markdown 是一種書寫的格式。就這樣，Markdown 的格式語法只涵蓋純文本可以涵蓋的范圍。
不在 Markdown 涵蓋范圍之內(nèi)的標簽，都可以直接在文檔里面用 HTML 撰寫。不需要額外標注這是 HTML 或是 Markdown；只要直接加標簽就可以了。
要制約的只有一些 HTML 區(qū)塊元素――比如 <div>、<table>、<pre>、<p> 等標簽，必須在前后加上空行與其它內(nèi)容區(qū)隔開，還要求它們的開始標簽與結(jié)尾標簽不能用制表符或空格來縮進。Markdown 的生成器有足夠智能，不會在 HTML 區(qū)塊標簽外加上不必要的 <p> 標簽。
例子如下，在 Markdown 文件里加上一段 HTML 表格：
這是一個普通段落。
<table>
<tr>
<td>Foo</td>
</tr>
</table>
這是另一個普通段落。
<table>
<tr>
<td>Foo</td><td>Foo</td>
</tr>
<tr>
<td>Hoo</td><td>Foo</td>
</tr>
</table>
請注意，在 HTML 區(qū)塊標簽間的 Markdown 格式語法將不會被處理。比如，你在 HTML 區(qū)塊內(nèi)使用 Markdown 樣式的*強調(diào)*會沒有效果。
HTML 的區(qū)段（行內(nèi)）標簽如 <span>、<cite>、<del> 可以在 Markdown 的段落、列表或是標題里隨意使用。依照個人習慣，甚至可以不用 Markdown 格式，而直接采用 HTML 標簽來格式化。舉例說明：如果比較喜歡 HTML 的 <a> 或 <img> 標簽，可以直接使用這些標簽，而不用 Markdown 提供的鏈接或是圖像標簽語法。
和處在 HTML 區(qū)塊標簽間不同，Markdown 語法在 HTML 區(qū)段標簽間是有效的。
