This page's audience our own tag's counts — open to see them

Period

–Visits

–Page views

–Clicks to vendors

–Time on page

–Reading now

Clicks to vendors, by tool

Top countries

Devices

– · visits, page views and clicks counted by our own tag, which counts more than our checked analytics; every figure rounded down · how we count

Widdershins

Free#16 of 28 in API Documentation ToolsApi Docs Documentation Generators

Widdershins: A flexible open-source converter for teams building API documentation pipelines. Ranked #16 of 28 in API Documentation Tools by our editors (7.1/10); pricing: Open source; best for teams converting OpenAPI into Markdown docs.

7.1/10Editor score

Visit Widdershins

Widdershins7.1 Visit Widdershins

At a glance

Editor score
7.1 / 10
Pricing
Open source
Best for
Teams converting OpenAPI into Markdown docs
Paid from
Free
OpenAPI import
Yes
Facts checked
20 Sep 2026

Where it wins
- Converts OpenAPI, Swagger, AsyncAPI, and Semoasa definitions
- Generates configurable code samples with language tabs
- Supports custom templates and external $ref resolution
Where it doesn't
- Does not provide interactive API references
- Requires local installation and self-hosted documentation workflows
- Configuration may require developer effort for custom output

Our verdict on Widdershins

Widdershins is an open-source Node.js command-line tool and JavaScript library for developers converting API definitions into documentation. It supports OpenAPI 3.x, OpenAPI 2.0, Swagger, AsyncAPI 1.x, and Semoasa definitions, with Markdown output suited to teams building documentation pipelines. It can also generate HTML and ReSpec-compatible formats, making it useful for projects that need source conversion rather than a hosted documentation workspace.

Its strongest capability is control over generated output. Widdershins creates configurable code samples with language tabs, supports custom user templates, handles schemas, and can resolve external $ref references. Markdown output is compatible with Slate and ReSlate, while the broader integration set includes Shins and ReSpec. Teams can work through the CLI or JavaScript API, which fits build processes that need documentation generation to run locally or as part of an existing development workflow.

Widdershins is a focused converter, not an interactive reference product or hosted documentation platform. Its self-hosted model gives teams responsibility for installation, configuration, output management, and the surrounding publishing workflow. That makes it a good fit for developers who want open-source tooling, format flexibility, and control over templates and generated samples. Teams looking for a managed platform with interactive API references, built-in hosting, or a more guided documentation experience should choose a different type of tool.

Your product? Our editors can test Widdershins in depth and publish a review, labelled as paid · from $149/mo →

Widdershins pricing

Plans Open sourceFree Free to use — no paid tier required for the core job.

See plans on github.com

Widdershins fact sheet

Free plan	Not verified
Paid from	Free
OpenAPI import	Yes
Interactive API reference	No
Code samples	Yes
API versioning	Not verified
Custom domain	Not verified
Hosting model	Self_hosted
Deployment	Self-hosted
Support	Community, Docs
Built for	Solo, Small business (editorial estimate)
Integrations	4 integrations: Slate, ReSlate, Shins, ReSpec
Pricing	Open source
Website	github.com
Facts checked	20 Sep 2026

Widdershins integrations

Widdershins lists 4 integrations on its own site.

Slate
ReSlate
Shins
ReSpec

Alternatives to Widdershins

See all Widdershins alternatives →

Also Ranked In

Widdershins is ranked in 3 of our directories.

Used Widdershins? Be the first to review it

The editor score above is our own research. What this page doesn't have yet is a reader's view — what you used Widdershins for, what worked and what didn't. No stars are seeded and no review is paid for; an editor reads every one before it appears.

Write a reviewTwo minutes · verified accounts only · read by an editor before it appears

Reviews come only from verified accounts. Sign in or create an account first — your e-mail is never shown.

Title

Your review

0 characters · at least 80, up to 3,000

Pros (optional · one per line)

Cons (optional · one per line)

Your name (shown with your review)

Role (optional)

Company (optional)

How long have you used it?

I've used Widdershins myself and this is my honest opinion — nobody paid or asked me to write it.

Posted from your verified account. Reviews appear after an editor reads them, usually within two working days.

Featured on iTechGuides

Widdershins is listed in our API Documentation Tools directory. Add the badge to your site — it links back to this page.

<a href="https://www.itechguides.com/products/widdershins/"><img src="https://www.itechguides.com/best/badge/widdershins.svg" alt="Featured on iTechGuides" width="230" height="46"></a>

Reviewed by iTechGuides Editors · Editorial team · Updated Oct 2026

Advertiser disclosure: iTechGuides is reader-supported. Vendors can pay for top positions in our rankings and for a place on other products' pages, and we may earn a commission when you click some links. Bought places stand at the number bought; this page and our disclosure say so. Paying vendors may get a fuller, more detailed review from our editors, and that review can change their score. How we rank.

Last updated 7 Oct 2026 · How we research and update