Formatting for Confluence

Thirty-eight macros for the pages Confluence’s own formatting can’t build: cards, banners, buttons, tabs, progress trackers, HTML, code and maths, all matched to one brand setting.

  • Built on Forge

Works insideCloud

Capable is used by teams at

A whole page, built from macros

A team home page using five Capable macros. Pick a number, or take the tour.

A Confluence page called Platform team home, built from a banner, buttons, cards, tabs and a progress tracker.

5 things to notice

A banner or a carousel

A headline, a line and a button on a photo or colour. Add slides and it becomes a carousel.

Banner
1 of 5

Buttons for the next step

Link a button to a page or a website. Each one has its own variant, size and corners.

Buttons
2 of 5

Cards as a visual index

Up to six cards, each with a title, a line, an image and a link. Columns, corners and shadow are set once for the grid.

Cards
3 of 5

Tabs for each audience

Readers jump straight to their part. Four tab styles, three sizes, horizontal or vertical.

Tabs
4 of 5

Where a process has got to

Numbered steps with the current one highlighted. Steps can link to the pages that belong to them.

Progress tracker
5 of 5

Try the macros

Pick a macro, change a couple of its real settings and see it on a sample page. Change the brand colour and every macro follows.

Sample

A sample page drawn in your browser. Settings follow the real macros.

Pick a macro

7 of 38 macros. See them all

Brand colour
Variant
Corners
Sample page

Team home

Everything the platform team publishes, in one place. Start with the guides below.

A row of styled buttons that link to a page or a website. Insert it with /buttons.

Buttons settings

What teams say

Excerpts from public reviews on the Atlassian Marketplace.

What makes it hold together

Thirty-eight macros you configure through a form, not markup, and one set of controls behind them.

The Presets page in the Macros area, with a Team Cards preset of three image cards ready to insert.

Thirty-eight macros in seven families

Panels and banners; cards, images and media; buttons and navigation; progress and status; technical and data; footnotes; page utilities. Most teams use around eight.

  • Sixteen ship starter templates
  • One image picker for every image macro

Pages worth reading

Pages worth reading: before and after
JobTodayWith Formatting
More than a meeting noteHeadings, tables and panels: enough for a meeting note, not for a landing page, a knowledge base article or an API reference.Panels, cards, buttons, tabs, progress, footnotes, code and maths, each configured through a form rather than by writing markup.Source: What Capable Formatting is
Pages that matchSix people build six pages, and the pages look like it.One brand setting gives every macro’s colour control your colours by default, without anybody being told how.Source: Set up your brand
Leaving another macro appEvery page that uses another vendor’s macros has to be rebuilt.A migration wizard converts them in place, using native Confluence elements where those do the job. Each change is a new page version, so it can be undone.Source: Migrating from another vendor’s macros

Moving from another formatting app

Formatting has more conversions in the migration wizard than anything else, because formatting apps ship the most macros.

  1. Backgrounds, banners, buttons, cards, LaTeX, tooltips, progress bars and trackers, footnotes and Swagger convert from several vendors.

    Migrating from another vendor’s macros
  2. Panels, expands, tabs, dividers, statuses and page trees convert to native Confluence elements rather than to another app’s macros.

    Migrating from another vendor’s macros
  3. Run a pilot space first. It takes about an hour and shows what will happen to your own content.

    Migrating from another vendor’s macros

Your first macro in about ninety seconds

  1. Step 1: Install

    Install Formatting from the Atlassian Marketplace. The macros are in the editor straight away.

    Get started
  2. Step 2: Insert a macro

    Type / in the editor and pick a macro, such as /cards. Start from a template, change two things and publish.

    Your first macro
  3. Step 3: Set up your brand

    Spend twenty minutes on brand guidelines and presets, so every later macro matches without anyone being told.

    Set up your brand

Questions, answered from the docs

Each answer links to the page it comes from.

Which macros are included?

Thirty-eight, in seven families: panels and banners; cards, images and media; buttons and navigation; progress, status and feedback; technical and data (code, LaTeX maths, Swagger/OpenAPI, tables, HTML and more); footnotes; and page utilities.
Source: Macros

Can the macros match our brand?

Yes. An administrator sets brand guidelines once, as themes with five colour roles, and every macro’s colour control starts from those colours. You can also save presets, up to ten per macro, that everyone starts from.
Source: Set up your brand

Can we migrate from Mosaic, Aura or Refined?

Yes. A migration wizard converts other vendors’ macros in place, so pages don’t have to be rebuilt. Where a native Confluence element does the job, the migration uses that. Each change is a new page version, so it’s reversible from page history.
Source: Migrating from another vendor’s macros

What do readers without an account see?

Macros that render from their own saved settings, such as panels, cards, buttons, tabs, footnotes, code and maths, work for them. Macros that have to fetch something when the page loads do not, because Confluence doesn’t let an app fetch on behalf of a reader it can’t identify.
Source: Readers without a licence or an account

Is it the same as the macros in Capable for Confluence?

The macros are identical and get the same updates at the same time. In the standalone app most names add the word “macro”. Content isn’t shared between the two products, so moving from one to the other is a migration.
Source: Suite or standalone

Can we add our own HTML?

Yes, with the HTML macro. Tailwind classes are styled automatically and you can add your own CSS. JavaScript only runs once an administrator has enabled it for the site, and then inside an isolated sandbox.
Source: HTML

Build a better page today

Install Formatting for Confluence from the Atlassian Marketplace, or book a demo and we’ll show you round.

Cookie Settings

We take good care of you and your data. You can read more about how we use cookies, the third parties who set cookies and update your cookie settings here.