by jonocarroll

jonocarroll / mathpix

Query the mathpix API to convert math images to LaTeX

205 Stars 21 Forks Last release: over 2 years ago (v0.3.0) 45 Commits 2 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:


Project Status: Active - The project has reached a stable, usable
state and is being actively
developed. CRAN\_Status\_Badge packageversion Last-changedate

Linux/Mac Travis Build
Status AppVeyor Build
Status codecov

Downloads GitHub
forks GitHub
stars Twitter


is now on CRAN, so you can install using

If you’re after newer development features (if there are any); you can install from GitHub using



The free API key has been removed due to overuse. Please sign up at then save your ID and key in your

file as

Note that this requires you to accept Mathpix’s terms and conditions and sign up for any relevant pricing scheme.

You can check that your credentials are loaded correctly with



If you have an image you would rather properly encode in LaTeX, for example

then simply calling


(with the appropriate path to the file) will insert a LaTeX block into your document which will render what the image represents

 \int \frac { 4 x } { \sqrt { x ^ { 2 } + 1 } } d x  

which renders to

Even complicated, hand-drawn figures work

 A = \left( \begin{array} { l l l } { 2 } & { 7 } & { 3 } \\ { 3 } & { 5 } & { 2 } \\ { 9 } & { 4 } & { 1 } \\ \end{array} \right)  

If your image only result in warnings and no LaTeX, use

retry = TRUE
to attempt some pre-processing of the image into a more amenable form. Unfortunately, there are still images which fail.

To not insert the resulting equation directly into your document, but rather store it in a variable, use

insert = FALSE

If you also wish to generate the images (although

will gladly do this for you) this can be achieved using
render_latex(latex, fileDir)


is the LaTeX generated by
(or any other escaped LaTeX) and
is the (optional) directory where you wish to save the image (by default, a temp file). This requires that you have
set up correctly and available on your machine.

API Documentation

Refer to

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.