Swagger / OpenAPI Macro

Owned by Boris Berenberg
Jul 25, 2022
2 min read

The Swagger / OpenAPI Macro lets you author your Confluence page using OpenAPI syntax. Your Swagger / OpenAPI content will seamlessly appear in your Confluence page as if you had written it using Confluence’s editor.

To use this macro:

  1. Type /swagger in your Confluence page.

  2. Choose the “Swagger / Open API” option.

  3. Pick which of the sources of LaTeX you want to embed. We support direct entry, a file attached to the Confluence page, or a Remote URL.

     

  4. Click the refresh icon next to the word Preview to see a preview of your content

 

Remote URL Support

We support embedding Markdown from the following sources:

  • Any public URL

  • Private Github Cloud Repositories

  • Private Bitbucket Cloud Repositories

  • Private GitLab Cloud Repositories

For private repository sources, we will ask the user who is viewing the Confluence page to oauth to the repository to ensure they have access to the file.