User Guide

Start Here - Guide by Role

Content Formatting Macros adds 30+ macros to the Confluence Cloud editor - no separate dashboard, no separate app to open. Everything happens inside a Confluence page in edit mode. Use this guide to find the fastest path for your role.

Content Author / Technical Writer

You write pages and want richer formatting.

Start with:

  1. Quick Start Guide - insert your first macro in under 2 minutes
  2. Tab Navigation Overview - create tabbed layouts from child pages or labels
  3. Alert Macro - highlight important notes, warnings, and tips
  4. How to: Build a Tabbed Knowledge Base Page - full page workflow

Best macros to learn first: Alert · Background · Tab Parent Content Mapper · Buttons · Advanced Expand


Space Administrator

You manage space structure and want consistent, well-organised content.

Start with:

  1. Tab Parent Content Mapper - generate tabs from child pages
  2. Page Templates - apply consistent layouts across a space
  3. Attachment Center Dashboard - audit attachments space-wide, find orphans, manage bulk actions
  4. How to: Build a Tabbed Knowledge Base Page - reference architecture for space-level hubs

IT / Security Team

You need to restrict what different audiences can see on the same page.

Start with:

  1. Conditional Show Guide - show content only to a specific Confluence user or group
  2. Conditional Hide Guide - hide content from specific Confluence user or group
  3. Privacy & Access Notes - how macros interact with Confluence permissions
  4. How to: Create Role-Based Content Visibility - full workflow

Confluence Administrator

You install apps and need to understand what this app accesses.

Start with:

  1. Installation & Setup - install from Atlassian Marketplace
  2. Permissions & Access - what the app can and cannot access
  3. Privacy & Access Notes - data residency and scope
  4. Attachment Management & Audit - storage and audit features