Using with vs. without WP Super Docs

2 min readUpdated September 19, 2026

There are two ways to use Nahnu Code and API Block: standalone, filling in blocks yourself, or paired with our WP Super Docs plugin, which can generate blocks for you from an OpenAPI specification. Both use the exact same blocks under the hood, the difference is only in how the blocks get filled in.

Standalone#

You add a block, or write a shortcode, and fill in every field yourself: the code sample, the endpoint’s method and path, the parameter list, and so on. Nothing is generated or synced from anywhere else.

This is a good fit for narrative documentation, guides, tutorials, and anywhere you are writing about code rather than describing a large API surface. It is also the only option if you do not have an OpenAPI specification for what you are documenting.

Paired with WP Super Docs#

WP Super Docs can read an OpenAPI specification and generate Endpoint, Parameters, Request/Response, Response Body, Status Codes, and related blocks directly from it. When your API changes and you re-sync, the blocks update to match, instead of your documentation slowly drifting out of date by hand.

This is the better fit once you have a real API surface to document, since keeping dozens of endpoints accurate by hand becomes its own maintenance burden. See the OpenAPI section for how the sync works, what it generates, and its fallback behavior if something in the spec cannot be read.

Using both together#

The two approaches are not exclusive. A common setup is to let WP Super Docs generate and maintain your API reference pages, while you write standalone Code Block or narrative content by hand for guides, tutorials, and getting-started pages elsewhere on the same site.

Which should you pick#

Writing a guide, tutorial, or a handful of code samples: standalone is simpler, no extra plugin needed.
Documenting a real API with more than a few endpoints: pair with WP Super Docs so the reference stays accurate as the API changes.
Not sure yet: start standalone. Nothing changes about how your existing blocks work if you add WP Super Docs later.