A plugin to enable mathjax on redmine
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
app/views Resolves the but with auto-preview of the redmine_wiki_extensions plu… Dec 27, 2015
lib/redmine_latex_mathjax/hooks Added custom settings for macro and MathJax configuration. Sep 14, 2015


Redmine LaTeX MathJax Macro Plugin

This is a simple little plugin which allows mathematical notation to be used within Redmine.


Redmine 3.0.x or 3.1.x. Other version are not tested but may work.


  1. Download archive and extract to /your/path/to/redmine/plugins/
  2. If you downloaded the zipball (https://github.com/process91/redmine_latex_mathjax/archive/master.zip), rename the extracted directory to 'redmine_latex_mathjax'
  3. (Optional) Modify init.rb. For example if you host MathJax yourself. You can point to your own MathJax location.
  4. Restart Redmine (e.g. by restarting Apache)

Login to Redmine and go to Administration->Plugins. You should now see 'Redmine LaTeX MathJax Macro'. Enjoy!


Anywhere on a wiki or issue page write for formulas:

{{mj(\sum_i x_i$)}}

or a multiline MathJax Syntax:

{{mj P_{POWER} = \cfrac {U_{POWER}} {I_{POWER}} }}

Hit 'Preview' or 'Save' to let them show up.


A: They do not show up in PDFs that are generated by using the PDF link below the wiki pages. See Closed Issue: Formula will not display in PDF export (https://github.com/process91/redmine_latex_mathjax/issues/1#issuecomment-4850823)

Because of the macro this can be changed in the future. To switch from client-side to server-side rendering.

Q: Why a macro? MathJax don't need that!

A: Macro is needed to bypass the markup language parser of Redmine. Like Markdown tries to convert underscores to em HTML tags. Also this enables us to do server-side rendering in the future.