大家都用什么写接口文档？

swagger 最近好像要改名叫OpenAPI了

markdown + docsify 将就中，就是有点累

接口文档必须swagger啊，目前的规范

来自酷炫的 CNodeMD

最后还是觉得postman最容易上手，而且可以方便地测试接口。各种需求均可实现。

之前一直用 apiary.io。Blueprint虽好但访问还是有点慢，而且和其他文档分散了。

琢磨了很久最后还是用 Markdown 手写最灵活。在 GitHub 的就写在 wiki 里，缺点是没有版本控制。