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

Question

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?

user_1259426 · Answer

You may need to check the project https://github.com/Mermade/widdershins It is a good tool that converts from Openapi specs to markdown. it is an npm module, and it is generating markdown to use on Redoc, but you can still customize the generated template

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

1 Answers