A comparison of various OpenApi(Swagger)-to-Slate markdown tools.
Currently compared are:
To see the output using each tool's defaults using the Swagger petstore demo, see here.
Disclaimer: the author of this repository and the blog post discussing the comparison is also the author of widdershins, and shins, the Node.js port of Slate used here to convert each tool's Slate markdown into HTML.
Because shins
uses markdown-it as it's markdown processor, there may be differences in the rendered HTML compared to that produced by Ruby Slate.
Each tool may be optimised for a particular Slate CSS theme. This is not taken into account here.
Only the example petstore.json
has been used so far to compare each tool, which may not demonstrate all features to best effect.