これを使う
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/