Swagger / OpenAPI Macro

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. Open

   

   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.
   
   

   Open

   

    

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.