適合寫接口文檔的工具，或者文本語法

由于后端與前端使用ajax交互，后端寫接口文檔變得非常有必要。以前我習(xí)慣用word寫接口文檔，但是最近與同事合作編寫后端，word并不適合使用svn工具做同步，因?yàn)閟vn、git等無法自動合并word。所以打算把文檔寫成文本的格式。

一開始想到的是用markdown語法來寫。markdown語法大全

但是接口文檔最重要的一個特性是，接口多，需要給每個接口標(biāo)序號（如下圖）。
當(dāng)然markdown支持序號，但是支持得并不完美，比如上下兩個序號之間最多只能有一個空行，并且空行不能寫文字，這樣就只能光寫接口標(biāo)題了，沒有空間寫接口內(nèi)容了。

請問適合寫接口文檔的方法是什么？最好就是一種語法，而不是一個軟件

感謝大家的回答，考慮到markdown目前的趨勢，還是決定繼續(xù)使用markdown，現(xiàn)在已經(jīng)想到解決辦法，markdown只是一種語法，到底怎么顯示，還是由軟件或者瀏覽器插件來決定的，我找到兩款chrome插件

Markdown Preview Plus

能自動把原文中的標(biāo)題提取出來生成目錄，并且能給目錄自動加序號（如果原文標(biāo)題本身就有序號，它也會加自己的序號，所以原文標(biāo)題不能有序號）

Markdown Viewer

同樣能把原文中的標(biāo)題提取出來生成目錄，但是不會加序號，對于不需要序號，或者接口較少的，可以用這個，我更喜歡這個插件的目錄樣式，可惜功能缺了一點(diǎn)。

這兩款插件其實(shí)是提供給文檔閱讀者的，文檔編輯者倒是可以不需要，全看個人喜好了，chrome官方市場里就找到這兩款了，不知道國內(nèi)有沒有人開發(fā)了插件沒傳到chrome市場