https://www.npmjs.com/package/swagger-markdown
做项目不是单纯的写完代码就结束了,还有文档,如果是接口开发,比较重要的一项就是接口文档,现在比较广泛使用的是swagger工具,在java中也提供了相应的swagger工具。虽然swagger很好用,但是在通用性上还是弱了一些,比如说记录到公司的文档工具就不是很方便。
而markdown是一种相对通用的文档格式,如果能把swagger的接口定义内容导出成markdown文档就好了。实际上却是也有很多这样的工具可以使用,不同的编程语言都有提供对应的swagger转markdown工具。
今天要介绍的是nodejs的swagger-markdown
https://www.jianshu.com/p/53274d7d7512
https://www.jianshu.com/p/349e130e40d5
https://github.com/mar9000/antmark
https://github.com/mar9000/antmark
https://github.com/mar9000/antmark/blob/master/src/org/mar9000/antmark/grammar/MarkdownParser.g4
it1352.com/1596776.html
https://blog.csdn.net/dnc8371/article/details/106702430