Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Swagger2Markup

github.com

  • Free plan
  • Linux
  • API
  • Self-hosted
7.1 Club score Visit github.com

What the maker publishes

Build output
AsciiDoc output can be converted to HTML, PDF, and EPUB using Asciidoctor tooling. source
CLI and Docker
The reference documentation includes command-line usage and a Docker image section. source
Compatibility limit
The project README says it supports Swagger 1.2 and 2.0 specifications and requires at least JDK 8. source
Configuration
Options include output markup language, output language, path grouping, generated examples, and document ordering. source
Conversion options
The converter can write output to a folder, write a single file, or return documentation as a string. source
Customization
It provides extension points for overview, paths, security, and definitions documents, and for modifying the Swagger model before conversion. source
Distribution
The documentation describes Swagger2Markup as a JAR library published in JCenter and Maven Central. source
Extensions
An extension SPI supports extending overview, paths, security, and definitions documents, and modifying the Swagger model before conversion. source
Formats
The documentation says AsciiDoc output can be converted to HTML, PDF, and EPUB using Asciidoctor tools. source
Generated documentation
By default, it generates four AsciiDoc files for overview, paths, security, and definitions, and can instead produce one file or a string. source
Input and output
It converts Swagger JSON or YAML into AsciiDoc, GitHub Flavored Markdown, or Atlassian Confluence Wiki documents. source
Input location
The Swagger source file can be local or accessible remotely over HTTP. source
Input location
The Swagger specification can be read from a local file or a remote URL accessible over HTTP. source
Integrations
The documentation describes use with Swagger JAX-RS, Springfox, Spring REST Docs, and Gradle or Maven plugins. source
Integrations
The project documents use with Swagger JAX-RS, Springfox, Spring REST Docs, and Gradle and Maven plugins. source
License
The project is licensed under Apache License 2.0. source
License
The project is licensed under Apache License 2.0. source
Maintenance
The README says the maintainer can no longer maintain the project alone and lists Swagger v3 support and bug fixes among topics needing help. source
Maintenance status
The maintainer says they can no longer maintain the project alone and welcomes community help, including work on Swagger v3 support and bug fixes. source
Output formats
It converts Swagger JSON or YAML into AsciiDoc, GitHub Flavored Markdown, or Atlassian Confluence Wiki documents. source
Output options
The converter can generate separate overview, paths, security, and definitions files, or produce one file or a string. source
Purpose
Swagger2Markup combines hand-written material with generated API documentation to produce REST API guides. source
Purpose
Swagger2Markup combines handwritten material with automatically generated API documentation to produce an up-to-date REST API guide. source
Runtime requirement
The project requires at least JDK 8. source

Checked against the maker's pages on 9 Oct 2026.