macOS
Homebrew已验证 · 100%
brew install swagger2markup-clilocal 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
安装行为
- 未记录 Homebrew bottle 元数据。
建议审查
在无人值守的代理使用前，请检查该工具是否读取明文凭据、写入远程状态、发布制品或调用插件。
可执行文件
已安装的可执行文件
| 命令 | 类型 | 暴露范围 | 备注 |
|---|---|---|---|
swagger2markup | 可执行文件 | 已索引可执行文件 | 从本地可执行文件索引发现。 |
新鲜度
版本和新鲜度
这些信号区分页生成时间、软件包管理器活动和上游发布比较。只有存在证据 URL 和可比较版本时，才会提示版本落后。
页面生成时间2026-08-03
管理器版本1.3.3
管理器更新时间
本地数据未知
上游不可用
检测到的最新版本未检测到
- OK没有生成新鲜度警告。
安装元数据
软件包元数据
| 软件包键 | brew:swagger2markup-cli |
|---|---|
| 版本 | 1.3.3 |
| 软件包管理器 | Homebrew |
| 主页 | https://github.com/Swagger2Markup/swagger2markup |
| Bottle | 未记录 |
| 服务 | 未声明 |
来源线索
由仓库数据生成
此页面由 av-web 从 scripts/generate-pkg-sqlite.py 生成的私有软件包 SQLite 工件提供。
Combined YAML source
View the package source record on GitHub.
使用的来源
- Geiger risk classifier
- cross-ecosystem install command graph
- curated package history
- pkg.so package database
- pkgdb category and tag curation