安装

其他安装命令

macOS

Homebrew已验证 · 100%

brew install swagger2markup-cli

local Homebrew formula metadata

概览

软件包摘要

Swagger to AsciiDoc or Markdown converter

项目链接

命令和别名

swagger2markup

历史

项目历史与用法

Swagger2Markup CLI is the command-line packaging of Swagger2Markup, a converter that turns Swagger JSON or YAML into AsciiDoc or GitHub Flavored Markdown. It sits in the documentation toolchain rather than the code-generation toolchain.

项目历史

The Swagger2Markup/swagger2markup repository was created on GitHub in February 2015. Its README says the project was created by Robert Winkler to simplify generation of up-to-date REST API documentation by combining handwritten material with auto-generated output from Swagger descriptions.

采用历史

The README lists Maven and Gradle plugin integrations, a demo using Spring Boot, Springfox, and Spring REST Docs, and companies that used Swagger2Markup. GitHub releases show 1.x releases through v1.3.4, while the Homebrew formula packages the 1.3.3 CLI jar from Maven Central.

使用方式

Swagger2Markup converts local or remote Swagger JSON/YAML files into several AsciiDoc or Markdown documents. The Homebrew formula test invokes the packaged CLI as `swagger2markup convert -i test.yaml -f test`, producing an AsciiDoc output file.

为什么软件包爱好者会关心

The package is notable because it reflects an era when API documentation pipelines were assembled from small CLIs, static site generators, AsciiDoc processors, and Swagger files. For maintainers, it is also an example of packaging a single Java jar as a Unix command with a stable executable name.

时间线

2015: GitHub repository created.
2016: v1.0.x releases added configuration, extension, security-document, and inline-schema features.
2018: v1.3.3 released.
2022: v1.3.4 listed in GitHub releases.
2026: Homebrew formula marks the CLI package deprecated as unmaintained.

Related projects

The README relates Swagger2Markup to Swagger, swagger-parser, markup-document-builder, Asciidoctor, asciidoctorj, Springfox, Spring REST Docs, and its Maven and Gradle plugins.

来源

安全态势

风险级别：绿色

narrow executable package without higher-risk signals.

风险分类器

绿色风险 · 低置信度 · appliance

原因

narrow executable package without higher-risk signals

信号

metadata:no-higher-risk-signals

安装行为

formula 元数据中未记录 Homebrew post-install 钩子。
Homebrew bottle 元数据适用于 1 个平台目标。
安装时包含 1 个运行时依赖。

建议审查

在无人值守的代理使用前，请检查该工具是否读取明文凭据、写入远程状态、发布制品或调用插件。

可执行文件

已安装的可执行文件

命令	类型	暴露范围	备注
`swagger2markup`	cli	全局可执行文件

新鲜度

版本和新鲜度

这些信号区分页生成时间、软件包管理器活动和上游发布比较。只有存在证据 URL 和可比较版本时，才会提示版本落后。

页面生成时间2026-07-26

管理器版本1.3.3

管理器更新时间2026-05-02

本地数据OK

上游not checked

信息No cached GitHub release or tag data was available.https://github.com/Swagger2Markup/swagger2markupnone 置信度

安装元数据

软件包元数据

软件包键	brew:swagger2markup-cli
版本	1.3.3
软件包管理器	Homebrew
软件包管理器页面	https://formulae.brew.sh/formula/swagger2markup-cli
主页	https://github.com/Swagger2Markup/swagger2markup
仓库	https://github.com/Swagger2Markup/swagger2markup
上游文档	https://github.com/Swagger2Markup/swagger2markup#readme
许可证	Apache-2.0
源码归档	https://search.maven.org/remotecontent?filepath=io/github/swagger2markup/swagger2markup-cli/1.3.3/swagger2markup-cli-1.3.3.jar
最后更新	2026-05-02T13:57:40+03:00
Pulse	updated
依赖	openjdk@11
Bottle	可用 (于 all)
Homebrew post-install	未定义
服务	未声明

注册表事实

源数据库详情

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	swagger2markup-cli
Version Scheme	0
Revision	3
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	yes
Disabled	no
Keg Only	no
URL Keys	stable

软件包图谱

链接来自本地软件包关系图、补充数据、依赖边、生态匹配和软件包 hub 归属。

来源线索

由仓库数据生成

此页面由 av-web 从 scripts/generate-pkg-sqlite.py 生成的私有软件包 SQLite 工件提供。

Combined YAML source

View the package source record on GitHub.

combined/swagger2markup-cli.yml

使用的来源

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated package history
package relationship graph
package version freshness
package-page enrichment

使用 Homebrew 安装 swagger2markup-cli