Tech riderRev. 4 Oct 2026
  1. 1Runs onAPI, Linux, self-hosted
  2. 2CostsFree plan
  3. 3OpenAPI importYes
  4. 4Interactive API referenceNo
  5. 5Code samplesYes
  6. 6Hosting modelself hosted
6 lines stated Written from the maker's own pages: github.com
The Widdershins homepage

Overview

Widdershins is ranked #15 of 38 in documentation generators on Specifiction. It runs on API, Linux, Self-hosted. There is a free plan.

Widdershins plans and pricing

All plans
Widdershins Free Open source MIT-licensed software · install via npm or clone the repository github.com · 4 Oct 2026

Compared on documentation generators

OpenAPI import
Yesgithub.com
Interactive API reference
Nogithub.com
Code samples
Yesgithub.com
Hosting model
self_hostedgithub.com

Facts

Purpose
Widdershins converts OpenAPI, Swagger, AsyncAPI, and Semoasa definitions into Markdown compatible with Slate and ReSlate.github.com · 4 Oct 2026
Pipeline
It is intended as a stage in an API documentation pipeline, converting API definitions for a renderer.github.com · 4 Oct 2026
Input formats
The project describes support for OpenAPI 3.x, OpenAPI 2.0, API Blueprint, AsyncAPI, and Semoasa inputs.github.com · 4 Oct 2026
Output formats
Widdershins can produce Markdown and can also output HTML directly or use ReSpec format.github.com · 4 Oct 2026
Templates
Users can customize output by editing or overriding the included templates.github.com · 4 Oct 2026
Integrations
The README describes using Widdershins with Slate, ReSlate, Shins, and ReSpec renderers.github.com · 4 Oct 2026
Install
The project can be installed globally with npm install -g widdershins or installed by cloning the repository and running npm i.github.com · 4 Oct 2026
API use
Widdershins can be called from Node.js using its convert function, which returns a Promise.github.com · 4 Oct 2026
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.github.com · 4 Oct 2026
Security
The README documents generated Authorization headers in OpenAPI code samples and provides an option to customize the API key value.github.com · 4 Oct 2026
License
The repository identifies its license as MIT.github.com · 4 Oct 2026

Best Widdershins alternatives

See all 20

Where it ranks on Specifiction

Is Widdershins yours?

Claim it for free: prove the domain, then correct facts, plans and screenshots. An editor reviews every change.

Sources