- Home
- API Documentation Tools
- Swagger2Markup
On the recordRead 9 Oct 202621 facts
Swagger2Markup
On the record
- Build output
- AsciiDoc output can be converted to HTML, PDF, and EPUB using Asciidoctor tooling.github.com · read 9 Oct 2026
- CLI and Docker
- The reference documentation includes command-line usage and a Docker image section.swagger2markup.github.io · read 9 Oct 2026
- Compatibility limit
- The project README says it supports Swagger 1.2 and 2.0 specifications and requires at least JDK 8.github.com · read 4 Oct 2026
- Configuration
- Options include output markup language, output language, path grouping, generated examples, and document ordering.swagger2markup.github.io · read 9 Oct 2026
- Conversion options
- The converter can write output to a folder, write a single file, or return documentation as a string.swagger2markup.github.io · read 4 Oct 2026
- Customization
- It provides extension points for overview, paths, security, and definitions documents, and for modifying the Swagger model before conversion.swagger2markup.github.io · read 4 Oct 2026
- Distribution
- The documentation describes Swagger2Markup as a JAR library published in JCenter and Maven Central.swagger2markup.github.io · read 9 Oct 2026
- Extensions
- An extension SPI supports extending overview, paths, security, and definitions documents, and modifying the Swagger model before conversion.swagger2markup.github.io · read 9 Oct 2026
- Formats
- The documentation says AsciiDoc output can be converted to HTML, PDF, and EPUB using Asciidoctor tools.swagger2markup.github.io · read 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.swagger2markup.github.io · read 4 Oct 2026
- Input and output
- It converts Swagger JSON or YAML into AsciiDoc, GitHub Flavored Markdown, or Atlassian Confluence Wiki documents.swagger2markup.github.io · read 4 Oct 2026
- Input location
- The Swagger specification can be read from a local file or a remote URL accessible over HTTP.swagger2markup.github.io · read 9 Oct 2026
- Integrations
- The project documents use with Swagger JAX-RS, Springfox, Spring REST Docs, and Gradle and Maven plugins.swagger2markup.github.io · read 9 Oct 2026
- License
- The project is licensed under Apache License 2.0.github.com · read 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.github.com · read 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.github.com · read 9 Oct 2026
- Output formats
- It converts Swagger JSON or YAML into AsciiDoc, GitHub Flavored Markdown, or Atlassian Confluence Wiki documents.swagger2markup.github.io · read 9 Oct 2026
- Output options
- The converter can generate separate overview, paths, security, and definitions files, or produce one file or a string.swagger2markup.github.io · read 9 Oct 2026
