Confluence macros

Your site shows the content you write with Confluence's own editor and macros, from formatted text and tables to panels, layouts and page properties. Each section below is a live example, published as part of this page, so you can see exactly how it looks to your visitors.

Where something looks different on a site, the section says so in one line.

#Text formatting

Every inline style in the editor carries over.

Bold, italic, underline, ~~strikethrough~~, inline code, H₂O, E = mc², coloured text, highlighted text and a link.

#Headings

Headings keep their level, so the outline of your page stays the same. Here are levels three to six.

#A level three heading

#A level four heading

#A level five heading

#A level six heading

#Lists

Bulleted, numbered and nested lists keep their order and indentation.

Plan the site
- Choose the spaces to publish
- Pick a theme
Publish it

Open the page in the editor
Make your change
Publish the site again to see it live

#Tables

Cell background colours and the column widths you set in the editor are kept.

Colour	Hex	Use it for
Blue	#DEEBFF	Information and links
Green	#E3FCEF	Things that are done or approved
Yellow	#FFFAE6	Things waiting on someone
Red	#FFEBE6	Things that are blocked

#Layouts

Two and three column layouts sit side by side on a wide screen and stack on a phone.

Left column. Use it for the main point.

Right column. Use it for the detail beside it.

First. Plan.

Second. Write.

Third. Publish.

#Panels

All five panel types, plus a custom panel with its own emoji and colour.

An info panel, for a useful aside.

A note panel, for something formal the reader should know.

A success panel, for a result the reader is looking for.

A warning panel, for a trap the reader should avoid.

An error panel, for something that will fail.

A custom panel, with the emoji and background colour chosen in the editor.

#Expand

An expand opens when a visitor selects its title, and can hold another expand.

Select to open this expand

This text is hidden until the expand is opened.

A nested expand

This text sits inside the nested expand.

#Status

Status lozenges keep their colour and text.

TO DO IN PROGRESS IN REVIEW WAITING DONE BLOCKED

#Date

A date shows the day it was set to.

The next review is due on Dec 1, 2026.

#Emoji

Standard emoji show as the emoji themselves.

😄 👍 🎉 🚀 ✅ ⚠️

#Action items

Action items show as a checklist, with finished ones ticked. Visitors cannot tick them.

Choose which spaces the site publishes
Add a custom domain
Publish the site

#Decisions

Decisions show with their decision marker.

The help site is published from the SITES space only.
Every page carries its own meta description.

#Table of contents

The list at the top of this page is the Table of Contents macro. It is built from the headings on the published page, so it always matches them.

#Excerpt

The content of an Excerpt macro is shown in place.

This sentence sits inside an Excerpt macro on this page.

#Include page

The Include Page macro shows another page's content in this one. Here it includes the Examples - Retrospective sample page, which has to be published on the same site.

Included page not found: Examples - Retrospective

#Page Properties

A Page Properties table shows as a normal table, and feeds the report below.

Owner	Capable documentation team
Status	CURRENT
Last reviewed	Nov 11, 2026
Audience	Anyone building a Capable Site

#Page Properties Report

This report lists the pages labelled sites-demo-properties that have a Page Properties table. On your site it lists only pages the site publishes, and it is refreshed each time the site is published.

Page	Owner	Status	Last reviewed
Confluence macros	Capable documentation team	CURRENT	Nov 11, 2026

#Live search

A Live search box searches your published site. This one searches the pages in this space.

#Smart links

An inline smart link to a page on the same site shows as a plain link with that page's title. A link to a Confluence page the site does not publish shows as plain text.

See Handy Macros for another demo.

#YouTube video

A YouTube link shown as an embed plays in the page.

#Code block

A code block keeps its text, spacing and line breaks. On a site it has no syntax colouring.

def greet(name):
    """Say hello to a visitor."""
    return f"Hello, {name}"

print(greet("reader"))