# Mermade/widdershins

OpenAPI / Swagger, AsyncAPI & Semoasa definitions to (re)Slate compatible markdown

Repository: https://github.com/Mermade/widdershins
Canonical: https://ross.abutalabs.com/products/widdershins
Homepage: https://mermade.github.io/reslate
Language: JavaScript
License: MIT
License Family: permissive
Topics: openapi, swagger, slate, api, documentation, asyncapi, semoasa, openapi3
Last push: 2024-06-04T23:50:09+00:00

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

## Adoption (not part of the score)
Stars 1580, forks 318 (observed 2026-08-28T04:05:06.913967+00:00)

## What it is
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
- artifact type: cli-tool
- maturity: maintenance
- function: documentation, api-documentation, markdown, cli
- domain: documentation, apis, developer-tools, web-development
- platform: cli, cross-platform
- tags: openapi, swagger, asyncapi, slate, semoasa, api-docs-generator, static-documentation, nodejs

## Member repositories
- Mermade/widdershins (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:06.913967+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-30T03:56:36.005822+00:00, confidence not recorded.
  - readme: https://github.com/Mermade/widdershins (fetched 2026-08-28T04:05:06.913967+00:00, sha 186433a23ad5)
  - homepage: https://mermade.github.io/reslate (fetched 2026-08-29T11:27:01.013522+00:00, sha f4d4ab8bc66d)
  - registry_npm: https://registry.npmjs.org/widdershins (fetched 2026-08-29T11:27:01.034985+00:00, sha d4908914557b)
- Data as of 2026-08-30T08:39:29.467469+00:00.