markdown 是非常不错的轻量级文本编辑语法，简书 和 GitHub 都支持。
我们从 七月份 开始使用 markdown 语法编辑接口文档，效果不错。
语法
- Markdown: Syntax
- Markdown 语法简体中文版
- Writing on GitHub：GitHub 支持的 markdown 语法。
- MultiMarkdown
- Adam Pritchard: Markdown Cheatsheet
- 简书帮助中心 之 献给写作者的 Markdown 新手指南
links 链接
行内式（inline-style） 和 参考式（reference-style）。
注：在阅读原文时，参考式比较流畅，不会有一堆链接妨碍思考，但在编辑时，因为需要把链接剥离出去单独定义（link definition），所以存在一致性维护问题，注意一下即可。
Links Example
I get 10 times more traffic from 谷歌 than from
Yahoo or MSN.
工具
避免 list 的方法
假如你不想使用列表（有时列表上下空间占有太多），则遇到 number-period-space （数字-点-空格）情况时，使用反斜杠 \ 将 . 转义即可：
1\. What a great season.
删除线（Strikethrough）
使用~~（两个波浪符号 tildes）标记删除线。
~~这句话将标记为删除~~
效果：
这句话将标记为删除
写技术文章的命令语法约定
- 对于互斥的元素用竖线（|）隔开；
- 可选元素用方括号（[]）括起；
- 必不可少的选项用花括号（{}）括起；
- 对于可选元素中必不可少的选项用 [{}] 括起；
- 对于需要逐字输入的命令和关键字，用 粗体 表示。在配置范例和输出（而不是命令语法）中，需要用户手工输入的命令用 粗体 表示；
- 对于你必须提供实际值的参数，用 斜体 表示或者<>括起；
