This topic created in 3418 days ago, the information mentioned may be changed or developed.
目前公司后端接口统一使用的是 office 。 也就是后端开发完成后，自己用 postman 测试，测试完毕后将参数和结果都写到 word 上。然后将 word 分类管理好后提供给前端，让前端根据 word 查看。
但是使用这种方法遇到一些问题。
- 本身 word 对编程语言的支持不够丰富，各种格式的数据拷贝过来就错乱了。想要在 word 里进行 json 的编辑也是非常不方便
- 是前端人员无法一目了然对整个文档有所了解。我虽然知道有目录这种东西，但是 office 也是有学习成本滴！
- 公司的程序员都比较抵触 office 。
不知道大家的公司怎么处理这个问题的？ 我现在的思路是换成 markdown 标记语言，然后通过 markdown 来解决这个问题不知道如何？
自己搭 1 个类似博客系统一样的东西，然后展示 markdown 。不知道这方面有什么成熟的解决方案没有？ 集思广益，谢谢大家！
 | 1 konakona Dec 19, 2016 早期用 WIKI ，学习成本较高。 现在有了 Markdown ，还犹豫什么？ |
 | 4 mopvhs Dec 20, 2016 |
 | 5 mrytsr Dec 20, 2016 via Android curl |
 | 6 donieleigh Dec 20, 2016 via iPad 团队抵制 office 说明水平比较高。我虽然觉得 markdown 比 office 好太多，但还是不够优雅，持续关注。 |
 | 7 FinnBai Dec 20, 2016 http://www.showdoc.cc/ 这个用着还不错,markdown 语法的,自带个模板 |
 | 8 xuwenhao Dec 20, 2016 via iPhone swagger 啊 |
 | 9 chairuosen Dec 20, 2016 当然 markdown 啊，配个 blog 系统可以 web 端查看，还可以全局查找接口，查看背锅人，版本控制，语法高亮，不要太爽。 |
 | 10 mzeht Jan 19, 2017 |
Select Language