javaopenapiswagger-3.0

Preferred way to convert openapi 3 document (json or yaml) to markdown, adoc or any other static format

I try to find an easy way in java to convert an openapi 3 document (json or yaml) in a static format like markdown, html or adoc. Searching around I've found a view projects like Swagger2Markup, but they aren't ready for Openapi v3!

Does anyone have any advice or an hint for a library or maven plugin for me?

Solution

  • Here is a good tool as well:
    https://rapidocweb.com/examples/example2.html

    Petstore illustrate the typical design decisions and tradeoffs a developer makes when building an enterprise application. The demo shows how to document REST API services OpenAPI format and is based on Petstore sample by swagger.io team. It was further extended by ReDoc Team.