Atlassian Tools
How to add math equations to Confluence (Cloud and Data Center)
•
min read

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.
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.
Open a page in edit mode. Create a page or click Edit on an existing one.
Type "/" and the macro name. For LaTeX Math+ for Confluence, type "/latex" and pick LaTeX Math+ Inline or LaTeX Math+ Block from the menu.
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.
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.
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

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 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.





