Content Formatting Macros for Confluence Cloud

LaTeX

The LaTeX macro can be used to convert LaTeX (a document preparation system) mathematical language to HTML.

This can be useful for displaying mathematical/scientific equations on a page, or formatting in a certain style.

This macro requires some previous knowledge of using LaTeX and LaTeX Mathematics. It may also be useful to review the documentation for MathJax, which enables the conversion between LaTeX and HTML and provides a range of informative examples on using the language.

Instructions

  1. Navigate to the page you would like to edit.

  2. Click the Edit icon in the top right of the page.

  3. Select Insert > View More in the Confluence editor.

  4. Select the LaTeX macro in the Select Macro screen.

    latex new
  5. Customize the appearance of your equations or formulas using the following parameters:

    • Block Equation Alignment: Select the alignment for block equations. Options include Left, Center (default), and Right.

    • Inline Equation Alignment: Select the alignment for inline text or equations. Options include Left (default), Center and Right.

  6. Add the desired text or equations in the Insert Text input area. Multiple formulas or equations can be included inside a single macro, and multiple macros can be included within a page.

  7. Click Insert. A macro placeholder is displayed.

    latex-placeholder

  8. Click Publish to view the macro rendered in the page.

    rendered-latex

Due to a Confluence limitation, the Export to PDF functionality does not work for content created with the LaTex macro. If you want to preserve your content in PDF format, we recommend that you use your browser’s built-in functionality to print to PDF.

Edit the Macro

To make changes to the macro parameters or text content, click the macro placeholder then click the Edit icon. Make the required changes, then click Save.

Inline vs Block Formatting

In order to display an inline equation, a single dollar sign must be placed either side of text within the macro, e.g. $ax^2 + bx + c = 0$. Block equations must include a double dollar sign on either side of the text to be rendered, e.g. $$x = {-b \pm \sqrt{b^2-4ac} \over 2a}$$. See the examples below.

Inline

inline

inline-rendered

Block

block

block-rendered

Formatting Examples

Matrix and Array

You can use an array to format equations similar to the example below.

array

array-rendered

A matrix can be applied to arrange formulas in columns with different delimiters such as the centered bracketed matrix below. matrix

matrix-rendered

Color

You can add color to your LaTeX formatting by adding a color parameter using the method below. latex-colour

rendered-latex

Packages

To provide extra functionality for the LaTeX macro, a number of LaTeX packages have been included.

These include Unit, mhChem, and Physics. To apply the required format, simply follow the formatting examples below.

Unit

unit-package

units-rendered

mhChem

chem

chem-rendered

Physics

physics

physics-rendered