# JMCuixy/swagger2word

一个Swagger API 文档 转 Word 文档的工具项目

Repository: https://github.com/JMCuixy/swagger2word
Canonical: https://ross.abutalabs.com/products/swagger2word
Language: Java
License: Apache-2.0
License Family: permissive
Last push: 2024-08-26T16:33:45+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3150, "days_push": 737, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1281, forks 632 (observed 2026-08-28T04:04:13.905629+00:00)

## What it is
A Java Spring Boot web application that converts Swagger/OpenAPI JSON specifications into downloadable Word documents. It accepts a Swagger JSON URL, an uploaded JSON file, or pasted JSON, renders it via Thymeleaf templates, and serves the generated .doc file.

## Use cases
- convert swagger  to word document
- generate api documentation in docx format
- export openapi spec as word file for offline sharing
- produce printable api reference docs for clients
- download swagger documentation as doc
- turn api spec into a deliverable document for non-developers

## When to choose
- you need Word-format API documentation from an existing Swagger/OpenAPI JSON
- you want a simple self-hosted web UI rather than a CLI or build plugin
- your team or clients require docx deliverables for API specs

## When to avoid
- you need Markdown, PDF, or HTML output instead of Word
- you want docs generated automatically in CI from code annotations
- your API spec is not Swagger 2.0 JSON

## Facets
- artifact type: application
- maturity: maintenance
- function: documentation, pdf, templating, http-server
- domain: documentation, apis, developer-tools, web-development
- platform: jvm, self-hosted
- tags: swagger, openapi, word-docx, api-docs, document-generation, spring-boot, web-server

## Member repositories
- JMCuixy/swagger2word (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:13.905629+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:58:16.893760+00:00, confidence not recorded.
  - readme: https://github.com/JMCuixy/swagger2word (fetched 2026-08-28T04:04:13.905629+00:00, sha c63ad8e155bd)
- Data as of 2026-08-30T08:39:29.467469+00:00.