如题，使用markdown格式写接口文档效率还是挺高的，因为你只需要关系接口的功能和内容，而不用在意排版，顺带提一下使用这个工具markdown_tables创建markdown格式的表格不要太方便！
需要说明的是如果是大型多人合作项目，还是老老实实用apidoc等工具吧。
接口大类
-----------
[toc]
-----------
### 接口1
#### 接口功能
> 接口说明
#### 接口地址
> 接口地址
#### 返回格式
> JSON
#### 请求方式
> GET
#### 请求参数
| 参数 | 必选 | 类型 | 默认值 | 说明 |
|------|------|--------|--------|-----------------------------------------|
| name | ture | string | foo | 请求的项目名 |
| type | true | int | bar | 请求项目的类型。1：类型一；2：类型二 。 |
#### 返回字段
| 返回字段 | 字段类型 | 说明 |
|----------|----------|----------------------------------|
| result | int | 返回结果状态。0：正常；1：错误。 |
| reason | string | 错误说明 |
| data | string | 数据 |
#### 字段变化
字段变化说明
#### 接口示例
> 地址：接口地址示例
#```json
{
"result": 0,
"reason": "success",
"data": []
}
#```
代码里的
#请删除