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

• [X] Create a cli.js file to execute commands using yarn or npm
• [X] Add more configurations (ie: custom templates)
• [ ] MDX templating support for platform that supports React components.

Contribute

PR's are more than welcome and highly appreciated.