Widdershins

4.9easy start · #38 of 38
in Documentation Generators

Runs on api, Linux, self-hosted.

Widdershins is ranked #38 of 38 in documentation generators on The Geeks Club. 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

Scalar 0 of 4 in the starter kit Lesson 17.4 Sphinx 0 of 4 in the starter kit Lesson 27.4 Kotlin/JS 0 of 4 in the starter kit Lesson 37.3 Asciidoctor 0 of 4 in the starter kit Lesson 47.2 Doxygen 0 of 4 in the starter kit Lesson 57.1 Redocly 0 of 4 in the starter kit Lesson 67.1

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.