http://blog.youkuaiyun.com/uxyheaven/article/details/49253757

什么是Markdown

Markdown 是一种轻量级的「标记语言」，它的优点很多，目前也被越来越多的写作爱好者，撰稿者广泛使用。

使用 Markdown 的优点

• 专注你的文字内容而不是排版样式。
• 轻松的导出 HTML、PDF 和本身的 .md 文件。
• 纯文本内容，兼容所有的文本编辑器与字处理软件。
• 可读，直观。适合所有人的写作语言。

Markdown 文档写作步骤

• 写Markdown格式的文档
• 转换成带有ToC的HTML

mac下首推Mou来写作

Markdown语法说明

http://wowubuntu.com/markdown/#list

or 下载了mou后, 看help -> Mou Help

Table of Content

基于ruby的转换工具 
https://github.com/i5ting/tocmd.gem

// 安装
sudo gem install tocmd

// 指定单个文件
sudo tocmd_local -f xx.md

// 指定目录
sudo tocmd -d .

效果如下:
   
1
2
3
4
5
6
7
8
9
10
   
1
2
3
4
5
6
7
8
9
10