Add TeX math equations to your Markdown documents rendered by markdown-it parser. KaTeX is used as a fast math renderer.
Simplify the process of authoring markdown documents containing math formulas. This extension is a comfortable tool for scientists, engineers and students with markdown as their first choice document format.
- Macro support
- Simple formula numbering
- Inline math with tables, lists and blockquote.
- User setting delimiters:
'dollars'(default)- inline:
$...$or$$...$$ - display:
$$...$$ - display + equation number:
$$...$$ (1)
- inline:
'brackets'- inline:
\(...\) - display:
\[...\] - display + equation number:
\[...\] (1)
- inline:
'gitlab'- inline:
$`...`$ - display:
```math ... ``` - display + equation number:
```math ... ``` (1)
- inline:
'julia'- inline:
$...$or``...`` - display:
```math ... ``` - display + equation number:
```math ... ``` (1)
- inline:
'kramdown'- inline:
$$...$$ - display:
$$...$$ - display + equation number:
$$...$$ (1)
- inline:
View a test table.
Install the extension. Verify having markdown-it and katex already installed .
npm install markdown-it-texmath
Use it with JavaScript.
tm = require('markdown-it-texmath'),
md = require('markdown-it')().use(tm, { engine: require('katex'),
delimiters:'dollars',
katexOptions: { macros: {"\\RR": "\\mathbb{R}"} }
});
md.render('Euler\'s identity \(e^{i\pi}+1=0\) is a beautiful formula in $\\RR 2$.')<html>
<head>
<meta charset='utf-8'>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex/dist/katex.min.css">
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/markdown-it-texmath/css/texmath.min.css">
<script src="https://cdn.jsdelivr.net/npm/markdown-it/dist/markdown-it.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/katex/dist/katex.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/markdown-it-texmath/texmath.min.js"></script>
</head>
<body>
<div id="out"></div>
<script>
document.addEventListener("DOMContentLoaded", () => {
const tm = texmath.use(katex);
const md = markdownit().use(tm, { engine: katex,
delimiters:'dollars',
katexOptions: { macros: {"\\RR": "\\mathbb{R}"} }
});
document.getElementById('out').innerHTML =
md.render('Euler\'s identity $e^{i\pi}+1=0$ is a beautiful formula in //RR 2.');
})
</script>
</body>
</html>Use following links for texmath.js and texmath.css
https://cdn.jsdelivr.net/npm/markdown-it-texmath/texmath.min.jshttps://cdn.jsdelivr.net/npm/markdown-it-texmath/css/texmath.min.css
markdown-it: Markdown parser done right. Fast and easy to extend.katex: This is where credits for fast rendering TeX math in HTML go to.
nothing yet
-
Support of inline syntax of display math ?
- Inline syntax of display math with
dollarsmode is supported starting from version "0.7.0". So'This formula $$a+b=c$$ will result in display math presentation', i.e. gets displayed on a separate line. For true inline math use$..$mode like before.
- Inline syntax of display math with
-
Multiline diplay math in
blockquoteblock possible ?- Display math inside of
blockquoteblocks is able to span multiple lines with version "0.7.3".
- Display math inside of
-
markdown-it-texmathwith React Native does not work, why ?markdown-it-texmathis using regular expressions withy(sticky) property and cannot avoid this. The use of theyflag in regular expressions means the plugin is not compatible with React Native (which as of now doesn't support it and throws an errorInvalid flags supplied to RegExp constructor).
-
Why doesn't
markdown-it-texmathwork with other engines ?markdown-it-texmathis a personal project of mine. As it does very well with KaTeX what I want it to do, I offer it to the public as an open source plugin. I do not have time or interest to integrate other math engines. But if someone wants to help here out, pull requests are always welcome.
- Infinite loop bug with
gitlabmode and display math insideblockquotesection removed. - Fundamental redesign of display math implementation.
- Update to KaTeX version 0.12.0.
- Regex bug with
gitlabmode removed.
- Experimental
pandocmode removed. Enhanceddollarsmode now does, whatpandocmode was requiring. - With
dollarsmode inline math expression$$..$$will result in display math presentation now. Adding equation numbers$$..$$(1)is not supported in inline syntax. - Significant code redesign and regular expression optimization results in more compact code and performance gain ... not measured though.
- Bug with display math inside of
blockquoteblocks removed.
- Now display math inside of
blockquoteblocks can span multiple lines, provided that every line starts with a>character. - Possible cause of [blockquote bug(goessner/mdmath#50)] presumably eliminated.
- Update to
markdown-itversion 11.0.0
- Now supporting katex options. Thanks goto Kirill.
- Removed a small bug in activation method.
- Hand instance of
katexover tomarkdown-it-texmathusingoptions.engineobject. Works withnode.jsand browsers. Withnode.jsoptions.engineentry{ engine:'katex' }as a string also works. - As a consequence of the topic before, the
usemethod ofmarkdown-it-texmathis deprecated now. - Add beta support for Pandoc syntax on request. Here waiting for test results.
- Using jsdelivr as cdn from now on.
- Add support for Julia Markdown on request.
- Remove pathological bug within blockquotes.
- Add support for Tex macros (https://katex.org/docs/supported.html#macros) .
- Bug with brackets delimiters .
- Add support for Kramdown .
- Fatal blockquote bug investigated. Implemented workaround to vscode bug, which has finally gone with vscode 1.26.0 .
- Escaped underscore bug removed.
- Backslash bug removed.
- Modifying the
blockmode regular expression withgitlabdelimiters, so removing thenewlinebug.
markdown-it-texmath is licensed under the MIT License