Acos Jekyll Open API helper is a gem written with Jekyll in mind. The gem produces .md files for all paths in the open api swagger json file.
# debug
gem build acos_jekyll_openapi_helper.gemspec -o ./_gems/debug.gem
# debug
gem build acos_jekyll_openapi_helper.gemspec -o ./_gems/release.gem
gem push _gems/release.gem
curl -u *rubygems.org email* https://rubygems.org/api/v1/api_key.yaml > ~/.gem/credentials