Write better and streamline your technical documentation with Macro Pack

Confluence is a powerful platform, but when it comes to technical documentation, its native formatting often feels restrictive. Architecture diagrams, API specifications, structured data, and technical markup quickly exceed what basic macros can handle. As a result, teams rely on screenshots, external links, or multiple apps that are difficult to maintain and keep in sync.

If your documentation struggles to keep up with your needs, the problem might be your tooling.

The problem with native Confluence formatting

Technical documentation requires more than headings and bullet points. Architecture diagrams need to be precise and maintainable. API documentation should be interactive and always in sync with the source. Code snippets, formulas, and data tables must be readable, structured, and easy to update.

With Confluence’s native macros, teams often face:

• Limited support for diagrams and visual modeling

• No native rendering for formats like Markdown, UML, or OpenAPI

• Static screenshots instead of live, versioned content

• Multiple plugins for different documentation needs

This results in fragmented documentation, higher maintenance costs, and slower onboarding for engineers and stakeholders.

One tool for every documentation need

Macro Pack was built to close these gaps. Instead of installing and managing multiple apps, teams can use a single macro pack to create rich, structured, and maintainable technical documentation directly in Confluence.

Macro Pack supports multiple documentation styles, so you can choose the format that fits your workflow.

Data & Structured Content

• CSV – display data as styled, sortable tables

• Excel – embed Excel files and preview spreadsheet content directly in the page

• JSON – present structured JSON data in a clean, readable format

Documents

• PDF – embed and preview PDF documents directly within the page

• Word – embed Microsoft Word documents for inline viewing

Text & Markup

• Markdown – render Markdown content

• AsciiDoc – render text written in AsciiDoc markup

• Code – display code snippets with syntax highlighting

• HTML – embed static HTML (JavaScript elements excluded for security) for custom layouts, with CSS support

• LaTeX – show mathematical formulas using LaTeX (math mode only; inline version available)

Diagrams & Visuals

• PlantUML – visualize system architecture and UML diagrams

• Mermaid – embed diagrams such as flowcharts, sequence diagrams, or Gantt charts

• BPMN – model business processes and workflows

• Draw.io – render diagrams created with draw.io (beta – limited shapes support)

• Excalidraw – embed sketch-style diagrams and visual notes

• Miro – embed Miro boards directly into Confluence pages for collaborative diagrams and workshops

API & Specifications

• OpenAPI / Swagger – display OpenAPI/Swagger specifications as interactive API documentation

Bring content from any source

Macro Pack doesn’t limit you to content stored in Confluence. You can pull content from:

• Raw file URLs, attachments, and inline text

• Secure, OAuth-accessed repositories and platforms, including GitHub, GitLab, Bitbucket, Dropbox, Atlassian, Google Drive, and Microsoft OneDrive

This allows teams to reuse existing files and keep documentation synchronized with external systems.

Fewer apps, better documentation

By bringing all these formats and sources together, Macro Pack helps teams:

• Reduce app sprawl and maintenance effort

• Create consistent, high-quality technical documentation

• Keep the page content up to date

And the best part? All macros are compatible with External Share for Confluence , so you can share your content securely with anyone!

Documentation That Grows with Your Architecture

Modern systems evolve quickly, and your documentation should evolve with them. Macro Pack gives technical teams the flexibility that Confluence is missing, without sacrificing security or maintainability. If Confluence’s native formatting is holding you back, Macro Pack is the upgrade your documentation deserves.

Write better. Streamline faster. Document smarter - all with Macro Pack .