by szhorvat

szhorvat / MaTeX

LaTeX labels in Mathematica

231 Stars 35 Forks Last release: about 2 months ago (v1.7.7) MIT License 201 Commits 23 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Join the chat at GitHub (pre-)release Github All Releases Contributions welcome DOI

English | 中文


Create LaTeX labels in Mathematica.

See the blog post for a detailed introduction to MaTeX and up to date troubleshooting information.


In Mathematica 11.3 or later, simply evaluate

to install or upgrade MaTeX.

In older versions that do not support resource functions, follow the manual installation instructions:

  • Download the latest release, distributed as a

    file, and install it using the
    function in Mathematica. For example, assuming that the file
    was downloaded into the directory
    , evaluate

    The most convenient way to obtain the path to a file is Mathematica's Insert → File Path... menu command.

  • Make sure that a TeX system and Ghostscript 9.15 or later are installed.

    For Windows and Linux, the latest Ghostscript is available from its official download page.

    On OS X, MacTeX 2015 and later already include a compatible version of Ghostscript. If you use an older TeX distribution that doesn't, please obtain a recent Ghostscript from Richard Koch's page.

  • Evaluate

    <.  MaTeX will attempt to auto-configure itself when it is loaded for the first time.  If auto-configuration fails, it will display instructions on how to configure the path to the 
    and Ghostscript executables manually. Note: On Windows systems use the command line Ghostscript executable, i.e. the one with the name ending in c:
  • Test MaTeX using


    Open the documentation center and search for "MaTeX" to get started.

Upgrading or uninstalling

A newer version can be safely installed when an older version is already present.

< will always load the latest installed MaTeX that is compatible with your version of Mathematica.

A list of all installed versions can be retrieved using


Any of the items in the list can be uninstalled by applying

to it. To uninstall all versions at once, use

To see more information about the version that gets loaded by

, use

Note: If you installed MaTeX before it started using the paclet distribution format (i.e. version 1.6.2), uninstall it by removing the

directory from the following location:
[email protected][{$UserBaseDirectory, "Applications"}]

The following function will automatically download the latest release of MaTeX and install it:

updateMaTeX[] :=
  Module[{json, download, target},
      json = Import["", "JSON"];
      download = Lookup[[email protected][json, "assets"], "browser_download_url"];
      target = FileNameJoin[{CreateDirectory[], "MaTeX.paclet"}];
        [email protected][ProgressIndicator[Appearance -> "Necklace"], "Downloading...", Right],
      URLSave[download, target]
    If[FileExistsQ[target], PacletManager`PacletInstall[target], $Failed]

After evaluating the function definition above, just run

, then
< to load the updated version.



to typeset using LaTeX. The latter will automatically apply

The LaTeX code is interpreted in math mode. Remember to escape backlashes (i.e. type two

characters when you mean one) when writing LaTeX code in Mathematica strings, e.g.
MaTeX["\\sum_{k=1}^{\\infty} \\frac{1}{k}"]

Multiple expressions can also be processed in one go:

  HoldForm[Integrate[Sin[x], {x, 0, 2 Pi}]],
  Expand[(1 + x)^5]

Processing a list of expressions together involves a single run of LaTeX, thus is much faster than processing each separately.

For many usage instructions, search for "MaTeX" in the documentation center.

Notes on performance

The limiting factor in the speed of

calls is running the
process, which might take as long as a second and cannot be sped up further. However, MaTeX caches results, making subsequent calls with the same TeX code near-instantaneous. MaTeX can also process a list of expressions using a single run of LaTeX, which is much faster than processing each separately.

Revision history

Version 1.7.7

  • Fix compatibility with Ghostscript 9.53.1

Version 1.7.6

  • Improved compatibility with Mathematica 12.0 and 12.1
  • Reliability improvements

Version 1.7.5

  • Documentation improvements
  • Improved error reporting

Version 1.7.4

  • Documentation improvements

Version 1.7.3

  • Added
    configuration option. This allows users to work around a
    bug in some Mathematica versions on Windows where
    would fail in a directory with non-ASCII characters in its name.
  • Exposed
    , to allow users to customize the expression to TeX code conversion. See Neat Examples in the MaTeX symbol documentation page.
  • Documentation improvements

Version 1.7.2

  • Better compatibility with the new documentation search in Mathematica 11.2
  • Better error reporting in case of Ghostscript failure
  • Documentation improvements

Version 1.7.1

  • Work around a rare
    bug that affects some Mathematica 10.0 installations on Linux
  • Documentation improvements, along with a new tutorial on figure preparation

Version 1.7.0

  • Internal refactoring, minor bug fixes and polish
  • New functions in
    to aid troubleshooting
  • Bug fix: running Ghostscript or pdflatex would fail on certain Linux distributions due to Mathematica changing

Version 1.6.3

  • More robust error checking and reporting
  • Documentation improvements

Version 1.6.2

  • The documentation is now integrated into the Documentation Center.
  • Bug fix: full compatibility with Mathematica 10.0 restored.

Version 1.6.1

  • Bug fix: better error checking for the CacheSize configuration option.

Version 1.6.0

  • MaTeX
    now threads over lists. A list is batch-processed using a single run of LaTeX, which is much faster than element-wise processing. Implemented by Andreas Ahlrichs.

    Note that this changes behaviour slightly. Previous versions of MaTeX compiled

    MaTeX[{1, x^2, x/2}]
    as a single expression. Now each element of the list is converted to a separate result. To restore the old behaviour, apply
    MaTeX[TeXForm[{1, x^2, x/2}]
  • Expressions with head

    are now automatically handled.
  • Bug fixes: Better handling of CR/LF line endings and character encodings.

Version 1.5.0

  • Much improved LaTeX error reporting. Please report any problems you notice with the new error reporting.
  • MaTeX now checks for common user errors and issues warnings. Turn them off using

Version 1.4.0

  • Separated
    options. The default preamble is now in
    . The
    option can be set without needing to worry about the default.
  • Package symbols are protected
  • MaTeX now follows the standard Mathematica package structure. This means that it now consists of multiple files. Move the entire MaTeX directory (and not just
    ) into
    to install.

Version 1.3.0

  • Added the
    options for easier debugging. Set them to
    to see the generated LaTeX code or the LaTeX log file.

Version 1.2.0

  • Added
    ContentPadding -> True
    ensures that the the output height is at least one line height
  • Added
  • The size of vertical borders is slightly different now: use
    LineSpacing -> {0, 14.4}
    to reproduce the older behaviour
  • Bug fixes

Version 1.1.1

  • Reliability fixes for Windows
  • Windows: Work around Mathematica bug causing MaTeX to fail when the current directory has special characters in its name
  • Windows: Ensure that auto-detected paths do not use
    as path separator

Version 1.1.0

  • MaTeX now attempts to automatically detect the location of Ghostscript and pdflatex on first run
  • Syntax highlighting for MaTeX functions (added SyntaxInformation)
  • Minor bug fixes and reliability fixes

Version 1.0.0

  • Minor bug fixes and compatibility fixes

Version 0.3

  • Bug fixes and other compatibility fixes: works with XeTeX and behaves better on Windows.

Version 0.2

  • Automatic baseline alignment. MaTeX output is now perfectly aligned with Mathematica text.
  • Improved positioning accuracy
  • Added
    option (now requires the
  • Support for some accented characters
  • More robust

Version 0.1

  • Initial release


MaTeX was primarily created for my own needs. However, if you find it useful, feel free to drop me an email.

Send feedback or bug reports to

or open an issue in the tracker.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.