What do I need to do for Math equations? #234

New Issue

claunia · 2026-01-29T14:31:00Z

claunia commented

2026-01-29 14:31:00 +00:00

Originally created by @bjthomson on GitHub (Oct 25, 2018).

Firstly, nice parser. Thank you. I'm struggling to get the Mathematics extension working, however.

I dont know Latex (I'm a markdown novice too), but I tried the test example,

$$
\begin{equation}
  \int_0^\infty \frac{x^3}{e^x-1}\,dx = \frac{\pi^4}{15}
  \label{eq:sample}
\end{equation}
$$

and it didn't show the integral symbol
I also tried the StackEdit samples:

The *Gamma function* satisfying $\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$ is via the Euler integral

$$
\Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,.
$$

StackEdit shows this:

I saw that Markdown Monster used MarkDig, but that doesn't render the equation either.

StackEdit mentions KaTeX, but I cant see a reference to that in the source. Looking at the page source in StackEdit, there is a bunch of HTML markup referring to KaTeX, but in my small test page, all I see is a div of class math?

I guess I'm missing something.
TIA

Originally created by @bjthomson on GitHub (Oct 25, 2018). Firstly, nice parser. Thank you. I'm struggling to get the Mathematics extension working, however. I dont know Latex (I'm a markdown novice too), but I tried the test example, $$ \begin{equation} \int_0^\infty \frac{x^3}{e^x-1}\,dx = \frac{\pi^4}{15} \label{eq:sample} \end{equation} $$ and it didn't show the integral symbol I also tried the StackEdit samples: The *Gamma function* satisfying $\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$ is via the Euler integral $$ \Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,. $$ StackEdit shows this: ![mathquery](https://user-images.githubusercontent.com/22427749/47488354-1793ce00-d83c-11e8-89a3-974fa678bb66.PNG) I saw that Markdown Monster used MarkDig, but that doesn't render the equation either. ![mathquery3](https://user-images.githubusercontent.com/22427749/47489904-8a527880-d83f-11e8-8d0d-6c50a97b0a2f.PNG) StackEdit mentions KaTeX, but I cant see a reference to that in the source. Looking at the page source in StackEdit, there is a bunch of HTML markup referring to KaTeX, but in my small test page, all I see is a div of class math? ![mathquery2](https://user-images.githubusercontent.com/22427749/47489359-5dea2c80-d83e-11e8-9782-b44ec4464d13.PNG) I guess I'm missing something. TIA

claunia added the question label 2026-01-29 14:31:00 +00:00

claunia closed this issue

2026-01-29 14:31:01 +00:00

claunia commented

2026-01-29 14:31:01 +00:00

@xoofx commented on GitHub (Oct 29, 2018):

So as you checked, markdig only generate a proper class/tag to detect math blocks. but it won't provide the rendering infrastructure. You need to plug an existing javascript Math framework for this (like KaTeX) and plug it into your final rendering page. Markdig doesn't generate a HTML page, it just generates a fragment of it.

Using with Katex, it should be something like this to process it (haven't tried this, but it should not be far from a version working):

<script>
  window.onload = function() {
      var tex = document.getElementsByClassName("math");
      Array.prototype.forEach.call(tex, function(el) {
          katex.render(el.textContent, el);
      });
  };
</script>

@xoofx commented on GitHub (Oct 29, 2018): So as you checked, markdig only generate a proper class/tag to detect math blocks. but it won't provide the rendering infrastructure. You need to plug an existing javascript Math framework for this (like KaTeX) and plug it into your final rendering page. Markdig doesn't generate a HTML page, it just generates a fragment of it. Using with Katex, it should be something like this to process it (haven't tried this, but it should not be far from a version working): ``` <script> window.onload = function() { var tex = document.getElementsByClassName("math"); Array.prototype.forEach.call(tex, function(el) { katex.render(el.textContent, el); }); }; </script> ```

claunia commented

2026-01-29 14:31:02 +00:00

@bjthomson commented on GitHub (Oct 29, 2018):

Ah I see, Thanks, i'll investigate.

@bjthomson commented on GitHub (Oct 29, 2018): Ah I see, Thanks, i'll investigate.

claunia commented

2026-01-29 14:31:02 +00:00

@jonkas2211 commented on GitHub (Dec 20, 2018):

Hallo @xoofx,

shouldn't that be documented in the spec file?
For example something like:
Note that you have to use a rendering engine like

<script src='https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js?config=TeX-MML-AM_CHTML' async></script>

@jonkas2211 commented on GitHub (Dec 20, 2018): Hallo @xoofx, shouldn't that be documented in the spec file? For example something like: Note that you have to use a rendering engine like ``` <script src='https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js?config=TeX-MML-AM_CHTML' async></script> ```

claunia commented

2026-01-29 14:31:03 +00:00

@xoofx commented on GitHub (Dec 21, 2018):

shouldn't that be documented in the spec file?

I would prefer this in a proper documentation page instead, but I haven't any spare time to bring documentation setup for markdig. I will leave this issue open until then.

@xoofx commented on GitHub (Dec 21, 2018): > shouldn't that be documented in the spec file? I would prefer this in a proper documentation page instead, but I haven't any spare time to bring documentation setup for markdig. I will leave this issue open until then.

claunia commented

2026-01-29 14:31:03 +00:00

@xoofx commented on GitHub (Mar 12, 2019):

Likely fixed by #311

@xoofx commented on GitHub (Mar 12, 2019): Likely fixed by #311

claunia referenced this issue

2026-01-29 14:46:43 +00:00

[PR #234] [MERGED] Fix spelling in package description #878

claunia referenced this issue

2026-01-29 14:46:46 +00:00

[PR #234] Fix spelling in package description #883

Sign in to join this conversation.