npm i mathmode


Turns LaTeX math mode expressions into images

by Mikola Lysenko

0.0.4 (see all)License:MITTypeScript:Not Found
npm i mathmode


This node.js module turns LaTeX math mode expressions into images.


The following one-liner will write a png image of the famous Euler identity to stdout:

require("mathmode")("e^{i \\pi} = -1").pipe(process.stdout)


This code uses the preview LaTeX environment and GraphicsMagick, which you will need to install. To do this on Debian, use the following command:

sudo apt-get install texlive texlive-latex-extra graphicsmagick

On OS X, you can do this using MacPorts:

sudo port install texlive texlive-latex-extra graphicsmagick

I have no idea how to do any of this on Windows or if this package will even work at all in that environment. If you do know how to use Windows, please open an issue/pull request with a fix.

Once all that is done, you can then install the npm package directly:

npm install mathmode

There is only one function in the module, which is the following:

require("mathmode")(expr[, options])

Turns the LaTeX expression expr into an image encoded as a stream. You can tweak this behavior a bit by specifying extra parameters via the options struct:

  • dpi: Dots-per-inch determines the resolution of resulting image. Default: 300
  • format: Resulting image format. Default png
  • packages: A list of extra LaTeX packages to include. Default ["amsmath"]
  • macros: A list of LaTeX preprocessor macros. Default ""
  • pdflatex_path: A path the pdflatex executable. Default: pdflatex
  • graphicsmagick_path: A path to Graphics Magic. Default gm

The result is a stream object for the resulting image.


(c) 2013 Mikola Lysenko. MIT License

No alternatives found
No tutorials found
Add a tutorial
No dependencies found

Rate & Review

No reviews found
Be the first to rate