Markdown写接口文档，自动添加TOC

上回说到，用Impress.js代替PPT来作项目展现。这回换Markdown来作接口文档好了。（不敢说代替Word，只能说我的感受更为方便）固然，还要辅之以Git，来方便版本管理。

Markdown基本语法也没啥好说的，随便百度一下几分钟看懂基本的，20%的知识完成80%的任务嘛，够了。

关键在于，我有些特殊需求，以方便将Markdown做为接口文档查看。什么需求呢？

1. 目录。这是重中之重。没有方便的TOC的话，文档长了，查看起来真是费劲。我理想中的目录是这样的：

   • 根据H1（# ）、H2（## ）号标题，自动生成索引，而不是网上其它人的什么标题都生成索引，弄一堆子乱七八糟的彻底没有接口文档的感受了。

   • 这个目录必定得是浮动在侧边栏的，不能说要查某个接口还得先回到页首去。

   • 这个目录还应该是自动折叠的，当我不须要它时它获得一侧缩着，不能碍事。

2. 表格样式，必定得是易读的，字体不能小，分界要明显，每行颜色要深浅交错开，表头颜色要更深。

3. 读取要方便，不能要求你们都装一个Markdown阅读器，否则又成Word了。我要求能直接从浏览器打开阅读。可是也不能说每次都上传到Github之类的地方去看，麻烦，并且Github也不支持自定义样式。最重要的是，我并无Github上的私有仓库。

Ok，就这些需求。我的感受要求不高吧？呵呵，找了半天还真没找到。因而乎，本身写了一个咯：https://github.com/zhengxiaoyao0716/MarkedWithToc。

简单来讲，就是一张网页。把写好的.md文件拖拽上去，而后按照以上需求生成html预览自动生成目录、黑白两种为接口文档优化过的主题，一键保存到本地。配合git作版本管理，应该会方便不少。

就这样，本次不是教程，不是学习笔记，只是一个建议和推广，给全部追求变化爱折腾的程序猿。懒得进GitHub的，直接打开这个连接便可使用：http://temp.zheng0716.com/MarkedWithToc/。注意，第一个一级标题会被无视，由于要做为文档标题嘛。