View on GitHub

widdershins

OpenAPI / Swagger, AsyncAPI & Semoasa definitions to (re)Slate compatible markdown

Download this project as a .zip file Download this project as a tar.gz file

Markdown TOC Structure

Structuring your input API document in order to generate the desired Table Of Contents (TOC).

OpenAPI/Swagger Tags Object

The top level tags object in OpenAPI provides the entries for the TOC. Each operation should link up to a tag, and providing a concise operationId on each operation provides the second level of ToC entries.

If an operation has more than one tag, then only the first is used, to prevent duplication of information.

AsyncAPI 1

In AsyncAPI v1 tags and topics are used in a similar way to that of OpenAPI in order to generate the TOC.

AsyncAPI 2

Semoasa

In Semoasa v1, the namespace and extension property keys are used to generate the TOC entries.