LaTeX in Confluence Cloud: the ways to write maths, compared
Confluence Cloud does not render mathematics on its own. There is no equation button, and typing $x^2$ leaves the dollar signs on the page. Teams that write formulas — engineering, finance, research, data science, teaching — use one of the approaches below.
1. Pictures of formulas
Write the formula somewhere else (a LaTeX editor, Word, an online tool), take a screenshot or export an image, and insert the image.
- Good for: a single formula that will never change.
- Downsides: nobody can edit it without the original; it does not match the text size or dark mode; search cannot find it.
2. A LaTeX macro for each formula
Marketplace apps such as LaTeX Math, LaTeX Math+ and others add a macro. Type /latex, enter the formula in a dialog, save.
- Good for: writing a few formulas by hand, when you want a dialog with a preview.
- Downsides: one dialog per formula. Text that already contains
$…$— from Markdown, Jupyter, GitHub or an AI assistant — has to be re-entered formula by formula.
3. A Markdown block
Some apps add a Markdown macro that renders a whole block of Markdown, maths included.
- Good for: pasting a Markdown file as-is.
- Downsides: the content lives inside one macro rather than as normal Confluence text, so inline comments, the normal editor and page search work differently.
4. Write $…$ in the page and convert it
This is the approach MathWrap takes. You write or paste maths the way Markdown does — $…$ inline, $$…$$ on its own line — directly in the normal editor. One command converts every formula on the page into rendered maths; another turns them back into text.
- Good for: pages with many formulas, text pasted from AI assistants or Markdown, and teams that prefer typing LaTeX to filling in dialogs.
- Also: a space administrator can make it automatic on publish; PDF and Word exports contain typeset formulas; formulas from LaTeX Math (Appfire) and LaTeX Math+ (Narva) can be migrated.
- Downside: formulas are rendered after you publish and convert, not while you type.
Which one should you use?
| Your situation | Best fit |
|---|---|
| One formula that never changes | A picture |
| A few formulas typed by hand, with a preview | A macro per formula |
| A whole Markdown document kept as one block | A Markdown macro |
| Many formulas, AI or Markdown text, frequent edits | Convert $…$ text (MathWrap) |
These approaches can live side by side. MathWrap only touches $…$ text and its own formulas, and converts other apps' formulas only when you ask it to.
Read the MathWrap user guide for how conversion, editing and exports work, or get MathWrap on the Atlassian Marketplace (free for up to 10 users).