Atlassian Tools

How to add math equations to Confluence (Cloud and Data Center)

•

10

min read

confluence math equations

Share Links

Author

Nar Kumar Chhantyal

Founder & CEO

Sharing Links

If your team has ever written technical documentation in Confluence, you’ve probably opened the editor, looked for an equation button, and come up empty. That’s because Confluence Cloud doesn’t have a built-in equation editor, and for teams that work with numbers every day, that’s a real gap.

Teams have found different ways around it. Some use workarounds that are fine for simple formulas, while others install a Marketplace app to get full equation support.

In this guide, we compare four ways to add math equations to Confluence Cloud, so you can choose the one that fits how your team works.

4 ways to add math equations to Confluence

You can add math equations to Confluence in four ways:

  • special characters

  • code blocks

  • equation images

  • app from the Atlassian Marketplace.

Here's a comparison of methods for Confluence math equations:

Method

Confluence Cloud

Confluence Data Center

Editable

Searchable

Survives PDF/Word export

Best for

Special characters and superscript

Yes

Yes

Yes

Yes

Yes

x², m/s², single Greek letters

Code block

Yes

Yes

Yes

Yes

Yes, as raw source

Formula source that readers copy into scripts

Equation image

Yes

Yes

No

No

Yes, as a bitmap

One-off formulas on pages nobody edits

Equation app

Yes

Yes, with a Data Center app

Yes

Varies by app

Varies by app

Fractions, integrals, matrices, any real notation


The first three methods require no installation and come in handy when you're adding equations in Confluence on a single page. However,  only an app produces formulas that render as real math and stay editable.  So, for fractions, integrals, or matrices, it is best to use one of the Confluence apps.

Method 1: Special characters and superscript/subscript (no app)

For short expressions like x², H₂O, or π, special characters work fine. On Confluence Cloud, you’ll find superscript and subscript in the text formatting menu, and if you need more symbols, the Unicode Mathematical Operators block alone has 256 of them.

This approach stops working once you get to fractions, integrals, or matrices, though. Plain text can’t stack terms on top of each other, so anything more complex than a single line is out of reach.

Method 2: Code block

A code block keeps a formula as copyable, searchable text. Type "/code" on Confluence Cloud then paste the formula source. Readers see the source, such as E = mc^2, not typeset math, which suits pages where people copy formulas into scripts.

Method 3: Equation images

Equation images come from Microsoft Word's equation editor or another math tool: you build the formula, take a screenshot, and paste it into the page. The result looks right once, but every change means a new image, and Confluence search cannot read it. Images also blur on high-resolution screens. According to MDN Web Docs, displays with a device pixel ratio of 2 draw each CSS pixel with four physical pixels, so a standard screenshot is stretched to fill them.

Method 4: Equation apps (visual or syntax-based editors)

Equation apps add inline and block equation macros that render real, typeset math on the page. They come in two editor styles:

  • Visual editors let you build formulas by clicking symbols and templates, so you need no syntax.

  • LaTeX editors let you type formula syntax, which is the fastest route for heavy notation once you know it.

If your team picks a syntax-based app, our LaTeX syntax guide covers fractions, integrals, matrices, and copy-ready examples.

Try LaTeX Math+ for Confluence free for 30 days

Add inline and block equations to Confluence Cloud, export them to PDF and Word, and migrate formulas from Data Center.

How to insert an equation in Confluence Cloud

To insert an equation in Confluence Cloud, install an equation app from the Atlassian Marketplace, open a page in edit mode, type "/" followed by the macro name, enter the formula, and publish. The steps below use LaTeX Math+ for Confluence by Narva Software as the example.

  1. Install an equation app. In Confluence Cloud, open Apps > Explore more apps, search for "math" or "equation", and install the app. Site admins install apps; other users request them.

  2. Open a page in edit mode. Create a page or click Edit on an existing one.

  3. Type "/" and the macro name. For LaTeX Math+ for Confluence, type "/latex" and pick LaTeX Math+ Inline or LaTeX Math+ Block from the menu.

  4. Choose inline or block. An inline equation macro sits inside a sentence, next to the surrounding text. A block equation macro puts the formula on its own line, which suits long or multi-line expressions.

  5. Enter the formula and check the preview. The editor shows a live preview as you type. LaTeX Math+ for Confluence also offers a formula library of ready-made expressions.

  6. Publish the page. Click Publish or Update. The equation renders for every reader, in light and dark mode.

All macro options are in the app documentation of LaTeX Math+ for Confluence by Narva Software

How to choose an equation app for Confluence

When you’re choosing an equation app for Confluence, there are seven things worth checking: which platforms it supports, what kind of editor it uses, which macro types it offers, whether equations survive PDF and Word export, how it handles dark mode, where the rendering happens, and what the migration path from Data Center looks like.


Criterion

What to check

LaTeX Math+ for Confluence

Platform support

Cloud, Data Center, or both. Data Center teams need a Cloud option before 2029.

Confluence Cloud only

Editor type

Visual (point-and-click) or syntax-based. Match it to who writes the formulas.

Syntax-based, with live preview and a formula library; no point-and-click editor

Macro types

Separate inline and block macros.

Inline and Block macros

PDF and Word export

Formulas render in exported files, not as raw code.

Exports to PDF and Word, rendered with MathJax

Dark mode

Formulas stay readable in Confluence dark mode.

Supported

Where rendering happens

Forge apps with the "Runs on Atlassian" badge render inside Atlassian's cloud, with no data egress.

Runs on Atlassian and Cloud Fortified badges

Migration path

A tool that converts formulas from your Data Center app.

Built-in migration from MathJax and LaTeX-based Data Center apps

Rendering location matters for security reviews: Forge apps run on Atlassian's own infrastructure, as our article on why Forge apps matter explains. Narva Software is SOC 2 Type II certified, and as of November 2026, LaTeX Math+ for Confluence is a Spotlight app on Atlassian Marketplace. Every Confluence formula you add stays in your Atlassian site. Need a point-and-click editor or a Data Center version? Compare other listings against the same checklist.

Moving from Data Center to Cloud: what happens to your equations

Your Confluence math equations survive a Data Center to Cloud migration only if a Cloud app supports the original macros; otherwise, migrated pages show an "unknown macro" error where each formula used to be. Equation apps store each formula inside the page, so the data moves, but Confluence Cloud needs an app that can render it. Here’s how to migrate LaTeX from Confluence Data Center to Cloud


adding math equations to Confluence

Frequently Asked Questions about adding math equations to Confluence

Can you add math equations in Confluence without an app?

Yes, but only simple ones. You can type Unicode symbols, use superscript and subscript formatting, paste a formula into a code block, or insert an equation image. None of these render fractions, integrals, or matrices as editable math. For anything beyond x² or a unit like m/s², install an equation app.

How do I insert an equation in Confluence Cloud?

Install an equation app from the Atlassian Marketplace through Apps > Explore more apps. Open a page in edit mode, type "/" followed by the app's macro name, and choose an inline or block equation macro. Enter your formula, check the live preview, and publish the page.

Does Confluence support LaTeX?

Confluence does not support LaTeX natively on Cloud or Data Center, so you add it with a Marketplace app; our guide on how to write LaTeX in Confluence covers the syntax for fractions and matrices, inline and block use, and copy-ready examples.

Do equations stay intact when I export a Confluence page to PDF or Word?

Equations from an app stay intact only if the app supports export. Some apps render formulas in the browser alone, so exported PDF or Word files show raw code or blank space. Before you commit, export a test page with a fraction and an integral, then open both the PDF and the Word file.

Can I edit an equation after publishing the page?

Yes, if the equation lives in an app macro. Open the page in edit mode, select the equation macro, and change the formula in its editor; the page updates when you republish. Equation images work differently: you have to rebuild the formula in another tool and upload a new image.

Nar Kumar Chhantyal

Founder & CEO

Nar is the founder of Narva Software and a former software developer with real-world experience using Atlassian tools. After facing the limitations of Jira and Confluence himself, he set out to build simple, effective apps that make teamwork easier. Today, his focus is on creating practical solutions that help teams work faster and smarter — and are trusted by companies around the world.

You might also like...

how to embed html in confluence

Confluence Cloud has no native HTML macro, so every rendering option runs through an app or an embed.

5
min
OpenAPI Confluence

OpenAPI (Swagger) for Confluence is a new Atlassian Marketplace app by Narva Software that turns any OpenAPI or Swagger spec into interactive API documentation on a Confluence Cloud page.

6
min
How to Bulk Export Confluence Pages to Markdown

Pick the right method to migrate Confluence to Markdown for Git, a docs site or an AI pipeline.

8
min