Showing results for 
Search instead for 
Did you mean: 
Copilot Lvl 2
Message 1 of 4

[FEATURE REQUEST] LaTeX Math in Markdown

Hi. I am using a math snippet in my markdown readme file in my repository. This is the code:

  * Experiences and leveling => every entertainment bot shall have this feature and this is
    no exception! The formula for leveling taken from experiences may change in future.
    Currently, no formula is used. I am, however, thinking of this one:
    $$n = x^{l + 1} - x^l$$
    $n$ is the required experience value to gain, $l$ is current level value, $x$ a further
    unspecified constant (it's value is not yet determined). The cooldown for experience gain,
    leveling and command fetch may be 15 seconds by default.


This is how it looks like in my markdown preview as displayed by VS Code Markdown and Markdown MathJax plugins:github_markdown_latex_showcase1.jpg


But this is how it looks like on GitHub:github_markdown_latex_showcase2.jpg


GitHub does not render LaTeX Math notations. Why? As far as I know, it did in past. Why was that feature removed? Could you bring it back again? It breaks the page intended use. Users can get it working in GitHub pages with few extra lines of code in _config.yml, but unfortunately that doesn't work with the internal markdown renderer at the repo view. I could simply use a Chrome extension, but the downfall of the extension is that it tries to interpret the LaTeX code even inside code blocks or in in-line code notations, which is wrong.

3 Replies
Message 2 of 4

Re: [FEATURE REQUEST] LaTeX Math in Markdown

Hi @Polda18 ,


Thanks for this feedback! We're always working to improve GitHub and the GitHub Community Forum, and we consider every suggestion we receive. I've logged your feature request in our internal feature request list. Though I can't guarantee anything or share a timeline for this, I can tell you that it's been shared with the appropriate teams for consideration.



Copilot Lvl 2
Message 3 of 4

Re: [FEATURE REQUEST] LaTeX Math in Markdown

Thank you 😊


It's really bad that math does not get recognised in inner GitHub markdown renderer. If I want to put math equation to the readme, it doesn't display correctly (as intended), it displays as is written in code.


Thank you for considering to include it 👍

Ground Controller Lvl 1
Message 4 of 4

Re: [FEATURE REQUEST] LaTeX Math in Markdown

Thank you for bringing attention to this topic to the appropriate teams! One thing I suggest is using KaTeX instead of MathJax, if math support were to be implemented in the near future, due to its efficiency compared to MathJax. Although KaTeX does not support all mathematical functions MathJax supports, it does heavily reduce the loading time for markdown files infused with mathematical operations!


Best regards!