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.