SwaggerをAsciiDocに変換する


これを使う
Swagger2Markup のdocker image
https://hub.docker.com/r/swagger2markup/swagger2markup/

使い方

$ cd (swagger.json がある場所)
$ docker run --rm -v $(pwd):/opt swagger2markup/swagger2markup convert -i /opt/swagger.json -f /opt/swagger

同じ場所に、swagger.adoc が出力さる。

入力は JSONだけでなくYAMLにももちろん対応されていて、出力はAsciiDoc以外のドキュメントにも対応している。
すばらしい。

詳しくはこちら http://swagger2markup.github.io/swagger2markup/1.3.1/