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

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 plansWiddershins 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 All accessCh 01 Scalar Free planAPILinux from $150/mo7.6 All accessCh 02 Asciidoctor Free planAPIBrowser Free to start7.5 All accessCh 03 Sphinx Free planAPILinux Free to start7.5 All accessCh 04 Kotlin/JS Free planLinuxMac Free to start7.4 All accessCh 05 Doxygen Free planLinuxMac Free to start7.1 All accessCh 06 mdBook Free planLinuxMac Free to start7.1
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
- github.com/Mermade/widdershins· checked 4 Oct 2026




