Just Add+ Embed Markdown, Diagrams, & Code in Confluence Git Cloud

Welcome to Just Add+, a suite of Confluence macros that enable you to embed and render advanced content formats such as Markdown, LaTeX, HTML, Diagrams, and OpenAPI directly in your Confluence Cloud pages.

This page explains how to use each macro effectively, how to manage content sources, and how to resolve common issues.

🛠️ Supported Macros Overview

Macro Name	Purpose

Macro Name	Purpose
Markdown	Render Markdown content
LaTeX	Display mathematical and technical formulas
HTML	Embed raw HTML code
Diagram	Create flowcharts, UML, Mermaid, etc.
AsciiDoc	Use AsciiDoc markup for documentation
Swagger / OpenAPI	Embed interactive API specifications

All macros support three input methods: Inline (text), Attachment, and Remote URL.

📥 Inserting a Macro

To use any Just Add+ macro:

Open or edit a Confluence page.
Type / and search for the macro (e.g., /markdown, /diagram, etc.).
Select the macro and choose your content source:
- Inline: Paste or write content directly.
- Attachment: Select a file uploaded to a page in your Confluence.
- Remote URL: Enter a raw file URL (e.g., GitHub, Bitbucket, GitLab).

⚠️ For private repositories, you will be prompted to authorize access via OAuth when viewing the page.

📚 Using Each Macro

Markdown Macro

Supports Markdown syntax.
Does not support inline HTML (stripped for security).
Use .md files or raw URLs from trusted sources.

LaTeX Macro

Accepts complete LaTeX syntax.
Must include \begin{document} and \end{document}.
Inline rendering is supported for simpler expressions.

HTML Macro

Embeds raw HTML content for advanced formatting.
Some tags (e.g., <script>, external CSS) may be blocked by Confluence.
Ideal for static HTML snippets only.

Diagram Macro

Supports PlantUML, Mermaid, and other formats.
Use .puml, .mmd, or inline syntax.
Ideal for technical architecture, sequence flows, or ER diagrams.

AsciiDoc Macro

For those using AsciiDoc markup as an alternative to Markdown.
Similar structure to the Markdown macro.

Swagger / OpenAPI Macro

Visualizes .yaml or .json OpenAPI specs.
Ideal for API documentation embedded directly in Confluence.
Requires valid Swagger/OpenAPI schema.

🔗 Content Sources

Input Type	Description

Input Type	Description
Inline	Directly paste or type content inside the macro editor.
Attachment	Upload the file to the current page and select it from the macro dialog.
Remote URL	Provide a direct link to a raw file (e.g., GitHub raw URL).

🧾 Example Use Case

Scenario: You want to embed a README.md from GitHub.

Create a new Confluence page.
Type /markdown and select the Markdown macro.
Choose “Remote URL” as the source.
Paste the raw GitHub URL (e.g., https://raw.githubusercontent.com/user/repo/main/README.md).
Save the page. The Markdown will render automatically.

📞 Support

Need assistance? Visit our Support Portal.