swagger2markup-cli ☆
« Back to VersTracker
Description:
Swagger to AsciiDoc or Markdown converter
Type: Formula  |  Tracked Since: Dec 28, 2025
Links: Homepage  |  formulae.brew.sh
Category: Developer tools
Tags: swagger openapi documentation asciidoc markdown cli
Install: brew install swagger2markup-cli
About:
Swagger2Markup CLI is a command-line tool that converts Swagger JSON/YAML specifications into AsciiDoc or Markdown formats. It transforms live API documentation into static, readable formats suitable for version control and documentation portals. This facilitates better API governance and integration with static site generators.
Key Features:
  • Supports conversion to both AsciiDoc and Markdown formats
  • Generates aggregated and separated API documentation files
  • Allows customization of output structure and content
  • Integrates easily into CI/CD pipelines for automated documentation generation
Use Cases:
  • Generating static API documentation for internal wikis or developer portals
  • Versioning API specifications alongside code in Git repositories
  • Creating printable PDF documentation from Swagger specs
Alternatives:
  • swagger-codegen – Focuses on generating client/server stubs rather than documentation, though it can generate some docs.
  • redoc-cli – Generates interactive HTML documentation, whereas Swagger2Markup focuses on text-based formats (AsciiDoc/MD).
Version History
Detected Version Rev Change Commit
Nov 8, 2024 11:20pm 3 VERSION_BUMP 31e6e463
« Back to VersTracker  |  Browse Packages  |  About