OpenAPI3 to Markdown converter
!
Convert OpenAPI v3 spec into a customizable directory of markdown files. The purpose of this tool is to boost documentation generation and seamlessly integrate them into static site generators.
Handlebars is used to provide fully configurable templating support.
Installation
yarn
yarn add @synx-ai/openapi2md
npm
npm install @synx-ai/openapi2md
Basic usage
CLI
Usage: openapi2md --specs [file] --target [target path] --templates [template path]
Options:
--version Show version number [boolean]
-s, --spec OpenAPI specification [required]
-o, --target target build path [default: "./build"]
-t, --template templates paths [default: "./templates"]
--help Show help
JavaScript
const convert = require('openapi2md').default;
convert('./example/petstore.json', './build');
Roadmap
Contribute
PR's are more than welcome and highly appreciated.