markdown
markdown是一個相對簡單的DSL,定義了簡單的標簽來描述html文檔格式。 比如:
- #一級標題 來生成html <h1>一級標題<h1>
- ##二級標題 來生成html <h2>二級標題<h2>
- [鏈接文字][link id] 與 [link id]:www.baidu.com 的組合來描述一個鏈接:
[鏈接文字][url name] [url name]: http://www.baidu.com
markdown的局限
使用了一段時間之后發現markdown所提供的鏈接標簽並不能很好地處理錨點問題。 即:[a link][id] 和 [id]: www.url.com的組合定義方式並不是完善。如:當我們在編寫文檔時可能並不知悉當前文檔的URL描述. 好在markdown在設計之初其實就想到了這點,在解釋md文檔的時候,解釋器會優先處理原生html標簽。這樣的話解決這個問題就就好辦了。
只需參考markdown的官方網站的markdown源碼與其網頁相對應分析:
- http://daringfireball.net/projects/markdown/syntax.text
- http://daringfireball.net/projects/markdown/syntax
md的第十三行overview 對應的描點地址是用html硬編碼的h2 id='overview'.
ref:
1. markdown語法參考: http://wowubuntu.com/markdown/
2. markdown問題: http://www.v2ex.com/t/3949