Widdershins

Spec sheet

Purpose

Widdershins converts OpenAPI, Swagger, AsyncAPI, and Semoasa definitions into Markdown compatible with Slate and ReSlate.Read 4 Oct 2026 · github.com

Integrations

The README describes using Widdershins with Slate, ReSlate, Shins, and ReSpec renderers.Read 4 Oct 2026 · github.com

Security

The README documents generated Authorization headers in OpenAPI code samples and provides an option to customize the API key value.Read 4 Oct 2026 · github.com

License

The repository identifies its license as MIT.Read 4 Oct 2026 · github.com

API use

Widdershins can be called from Node.js using its convert function, which returns a Promise.Read 4 Oct 2026 · github.com

Code samples

It supports customizable code samples, including language tabs, and can use httpsnippet to generate samples.Read 4 Oct 2026 · github.com

Input formats

The project describes support for OpenAPI 3.x, OpenAPI 2.0, API Blueprint, AsyncAPI, and Semoasa inputs.Read 4 Oct 2026 · github.com

Install

The project can be installed globally with npm install -g widdershins or installed by cloning the repository and running npm i.Read 4 Oct 2026 · github.com

Limits

Schema examples default to a maximum depth of 10, and referenced request body schemas are not expanded by default unless they have an inline schema.Read 4 Oct 2026 · github.com

Output formats

Widdershins can produce Markdown and can also output HTML directly or use ReSpec format.Read 4 Oct 2026 · github.com

Pipeline

It is intended as a stage in an API documentation pipeline, converting API definitions for a renderer.Read 4 Oct 2026 · github.com

Templates

Users can customize output by editing or overriding the included templates.Read 4 Oct 2026 · github.com

Plans and prices

Every Widdershins plan and price →

Where Specifiction places it

• Documentation Generators#28 of 377.1
• API Documentation Tools#24 of 277.2
• Api Docs#17 of 197.2