Mathwise user guide

Mathwise adds LaTeX mathematics to Confluence Cloud pages.

Writing a formula

• Type /math in the editor and choose Math (inline) for a formula inside a sentence, or Math (display) for an equation on its own line.
• Write LaTeX in the box. The preview below it shows the formula as readers will see it. Typing a backslash suggests commands; the palette under the box inserts symbols, structures and templates.
• Press Enter to save, Shift+Enter for a new line, and Escape to cancel. A formula with an error shows the error and cannot be saved, so readers never see a broken formula.
• To change a formula, select it and click the edit button.

Typing dollar signs

Write $x^2$ for an inline formula or put $$\int_0^1 f(x)\,dx$$ on a line of its own for a display equation, then publish. A few seconds later Mathwise turns them into formulas and Confluence offers to reload the page. Prices such as "$20 and $30" stay plain text, \$ is always a literal dollar sign, and text formatted as code is never converted.

Numbered equations and references

Environments such as equation and align, and \tag, are numbered (1), (2), (3) in page order across all of a page's formulas. Put \label{name} in an equation and write \eqref{name} or \ref{name} in any formula on the same page; an unknown label shows (??). Numbers update a few seconds after each publish.

Shared macros for a space

A space admin can define LaTeX commands once for every formula in a space: Space settings → Integrations → Mathwise LaTeX. For example \newcommand{\R}{\mathbb{R}} or \DeclareMathOperator{\tr}{tr}. Inline formulas use a change at once; display equations and exports can take up to a day, because Confluence caches them.

Switching from another math app

A Confluence administrator opens Mathwise in Confluence administration, chooses spaces, clicks Count formulas to see what each space holds, then Convert formulas. Formulas from LaTeX Math (Appfire), LaTeX Math+ (Narva), LaTeX for Confluence (Bertly) and Data Center LaTeX macros are converted in place. Each changed page gets one new version, so earlier versions stay in the page history. Anything Mathwise cannot convert stays exactly as it was and is listed with the reason.

Export, themes and supported LaTeX

Formulas appear in PDF and Word export and follow Confluence's light and dark themes. Mathwise renders with MathJax 4 and the AMS packages, mathtools, physics, mhchem, braket, cancel, color, enclose, amscd, boldsymbol, newcommand and textmacros.

Licensing

If a site's Mathwise license lapses, every formula stays visible and in exports, but new formulas cannot be saved, dollar signs are not converted and conversions cannot start until an admin renews it in Manage apps.

Privacy and support

Mathwise runs entirely on Atlassian's platform and sends no data outside it. Questions and problems: mathwise@officehoursmath.com.