Swagger2Markup
The facts below are what the maker publishes about Swagger2Markup, checked and dated. Our editors have not written about it yet.
The facts
Each one read from Swagger2Markup's own pages, with the date it was checked.
What it does
- Build output
- AsciiDoc output can be converted to HTML, PDF, and EPUB using Asciidoctor tooling.checked 9 Oct 2026
- CLI and Docker
- The reference documentation includes command-line usage and a Docker image section.checked 9 Oct 2026
- Compatibility limit
- The project README says it supports Swagger 1.2 and 2.0 specifications and requires at least JDK 8.checked 4 Oct 2026
- Configuration
- Options include output markup language, output language, path grouping, generated examples, and document ordering.checked 9 Oct 2026
- Conversion options
- The converter can write output to a folder, write a single file, or return documentation as a string.checked 4 Oct 2026
- Customization
- It provides extension points for overview, paths, security, and definitions documents, and for modifying the Swagger model before conversion.checked 4 Oct 2026
- Distribution
- The documentation describes Swagger2Markup as a JAR library published in JCenter and Maven Central.checked 9 Oct 2026
- Extensions
- An extension SPI supports extending overview, paths, security, and definitions documents, and modifying the Swagger model before conversion.checked 9 Oct 2026
- Formats
- The documentation says AsciiDoc output can be converted to HTML, PDF, and EPUB using Asciidoctor tools.checked 4 Oct 2026
- Generated documentation
- By default, it generates four AsciiDoc files for overview, paths, security, and definitions, and can instead produce one file or a string.checked 4 Oct 2026
- Input and output
- It converts Swagger JSON or YAML into AsciiDoc, GitHub Flavored Markdown, or Atlassian Confluence Wiki documents.checked 4 Oct 2026
- Input location
- The Swagger specification can be read from a local file or a remote URL accessible over HTTP.checked 9 Oct 2026
- Integrations
- The project documents use with Swagger JAX-RS, Springfox, Spring REST Docs, and Gradle and Maven plugins.checked 9 Oct 2026
- License
- The project is licensed under Apache License 2.0.checked 9 Oct 2026
- 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.checked 4 Oct 2026
- 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.checked 9 Oct 2026
- Output formats
- It converts Swagger JSON or YAML into AsciiDoc, GitHub Flavored Markdown, or Atlassian Confluence Wiki documents.checked 9 Oct 2026
- Output options
- The converter can generate separate overview, paths, security, and definitions files, or produce one file or a string.checked 9 Oct 2026
- Purpose
- Swagger2Markup combines handwritten material with automatically generated API documentation to produce an up-to-date REST API guide.checked 9 Oct 2026
- Runtime requirement
- The project requires at least JDK 8.checked 9 Oct 2026
- Support
- The project README directs questions to Gitter and asks users to report bugs and enhancement requests through GitHub issues and pull requests.checked 9 Oct 2026
