A Swagger to AsciiDoc or Markdown converter to simplify the generation of an up-to-date RESTful API documentation by combining documentation that’s been hand-written with auto-generated API documentation.
Why do you think that https://github.com/ruby-grape/grape-swagger is a good alternative to swagger2markup