Mermade/widdershins

Health v2 · maintenance only

Adoption not part of the score

1580 stars · 318 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Widdershins is a Node.js CLI tool and library that converts API definitions in OpenAPI 3.x, Swagger 2.0, AsyncAPI, and Semoasa formats into Slate/ReSlate-compatible markdown or ReSpec HTML. It is typically used as a stage in static API documentation pipelines.

Use cases

• generate slate-compatible markdown from an openapi 3 spec
• convert swagger 2.0 definition to static api documentation
• produce markdown docs from asyncapi definition
• build api reference documentation pipeline from openapi
• generate html api docs with respec from openapi file
• create multi-language code sample documentation from api spec

When to choose

• you already have an OpenAPI/Swagger/AsyncAPI definition and want static markdown docs
• you use Slate or Shins as your documentation renderer and need input conversion
• you want a scriptable, pipeline-friendly docs generator with customizable templates

When to avoid

• you want a hosted, interactive API documentation portal with a GUI
• you need live 'try it now' API exploration rather than static docs
• you don't have an API definition file to start from

Facets

cli-tool · maturity maintenance

documentation api-documentation markdown cli documentation apis developer-tools web-development cli cross-platform openapi swagger asyncapi slate semoasa api-docs-generator static-documentation nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="Mermade/widdershins")