This plugin for Atlassian Confluence, provides a thin wrapper around MathJax. MathJax is an open source JavaScript display engine for mathematics that works in all modern browsers.

Two macros for Confluence are provided: mathinline and mathdisplay. They both accept mathematics in Latex notation and output either an inline equation (within the main text) or a displayed equation (separate from the main text, typically centered on the page). AMSmath extensions for Latex are also enabled.

Help is provided in the Confluence Notation Guide under the Advanced Formatting tab.

A few simple examples:

• {mathinline}\frac{x}{y}{mathinline} a nice fraction.
• And to get a nice integral, simply use {mathdisplay}\int_{-\infty}^\infty \mbox{e}^{-x^2} \mbox{d}x.{mathdisplay}
• Or using some AMS math features:

  {mathdisplay}
    \begin{bmatrix} \dot x\\ \dot y\end{bmatrix} =
      \begin{bmatrix}a_{1,1} & a_{1,2}\\ a_{2,1} & a_{2,2}\end{bmatrix}
      \begin{bmatrix}x\\ y\end{bmatrix}
  {mathdisplay}

This should produce (also using MathJax on this page!):

• \( \frac{x}{y} \) a nice fraction.
• And to get a nice integral, simply use \[ \int_{-\infty}^\infty \mbox{e}^{-x^2} \mbox{d}x. \]
• Or using some AMS math features: \[ \begin{bmatrix} \dot x\\ \dot y\end{bmatrix} = \begin{bmatrix}a_{1,1} & a_{1,2} \\ a_{2,1} & a_{2,2}\end{bmatrix} \begin{bmatrix}x\\ y\end{bmatrix} \]

At the moment this plugin definitely works for Atlassian Confluence 3.4-4.1 and possibly for earlier versions (I haven't tested below 3.4). If you install in Confluence 3.x, it might complain that some dependencies are not fulfilled. This is normal and due to the fact that the macro format has changed with Confluence 4.x.

You can grab the source code from GitHub.

The plugin is now on the Atlassian Plugin Exchange. It can also be downloaded from the downloads section at GitHub. Finally, it is also here: mathjax-1.1.zip.

If you don't want to compile the plugin yourself, download the binary from the link above.

The easiest way to compile this plugin is to download the Atlassian SDK and simply type

atlas-package

Alternatively, use

atlas-run

to automatically run a Confluence instance with the plugin installed (uses a development licensed Confluence). Different versions of Confluence can be tried using

atlas-run --version 3.5.13

The src/main/resources/mathjax directory contains a pristine copy of MathJax v1.1a. It can be updated as necessary to newer versions of MathJax as and when they are released, provided that the configuration mechanism does not change from version to version.

Note: MathJax itself is not included in the source repository. Simply download it from the MathJax website and unpack in the appropriate directory. MathJax.js should end up as src/main/resources/mathjax/MathJax.js.

If you've got any comments/queries about this plugin, feel free to email me at davebarton@cityinthesky.co.uk.