No. 37 of 38 ·Documentation Generators

Widdershins

Linux · Self-hosted · API

Freedom report

One barScore 4.8

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

Widdershins plans and pricing

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

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

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