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.

Want to get started, but don't have the app? See our Installation page to learn more.

## Instructions

Navigate to the Confluence page you would like to edit.

1. Click the Edit icon in the top right of the page.
2. Select Insert > View More in the Confluence editor.
3. Select the LaTeX macro in the Select Macro screen.
4. 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.
5. 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.
6. Click Insert. A macro placeholder is displayed.
7. Click Publish to view the macro rendered in the page.

PDF Limitation: Due to a Confluence limitation, the Export to PDF functionality does not work for content created with macros that use JavaScript to render on a Confluence page; this includes Orah's 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.

### Formatting Examples

##### Matrix and Array

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

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

##### Color

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