在docfx中,最重要的就是生成文檔,把markdown文件(gfm語法)轉換成html。html
爲了這一步,咱們找了N個.net開源項目,發現要麼是common markdown的,要麼不容易擴展,沒有一個是基於gfm的而且很容易擴展的語法的markdown開源項目。無奈之下,再找.net下執行js的engine,結果發現要麼用jint這個解釋engine慢慢跑,要麼就不能跨平臺,或者就各類問題。哎,真是讓人抓狂啊。。。git
走投無路之下,仍是本身寫一個吧,把marked.js的邏輯先翻譯一遍,參考了各個版本的c#版markdown實現,接着各類重構修改再重構後,終於成型了,這就是docfx中使用的自制markdown engine-----MarkdownLite。github
由於沒有時間寫文檔,如今的api文檔幾乎仍是一片空白,只有類型等基本信息。在稍後的一段時間內,咱們會補上文檔。c#
關於源代碼:MarkdownLite的源代碼將與docfx的源代碼一塊兒開源api
關於nuget:請搜索關鍵字Microsoft.DocAsCode.MarkdownLitemarkdown