5 ms·

Convert LaTeX notation to ready to be embedded Markdown

42 points by 8HoLoN 5y ago

8HoLoN 5y ago
I'm the author of the tool, I hope this will be useful to some of you in case you need to put mathematical formulas in your README.md
- kzrdude 5y ago
  Nice. There are unescaped ()'s in the URL, will this work correctly?
  - 8HoLoN 5y ago
    It's seems to work with the parenthesis as is.
    - kzrdude 5y ago
      In all markdown parsers?
gus_massa 5y ago
Which packages does it support? I tried \cancel and it works :)
- 8HoLoN 5y ago
  I don't really know, it's built over the latex.codecogs.com web services.
andreareina 5y ago
Is codecogs ok with you using their free service this way?
oefrha 5y ago
This just embeds an image from a third-party commercial service https://latex.codecogs.com/ https://latex.codecogs.com/. I don’t think this is a good idea. The “Buy Now” link on that site even 404s; I seriously doubt the longevity of that service. Just use Pandoc with good old KaTeX or MathJax. The CDN builds will last way longer than this commercial service, and you have the option of self-hosting everything. Edit: I didn't see the author's comment here. Apparently it's meant for environments where you aren't allowed to include your own JavaScript. In that case it's probably a good idea to prerender the images and include them alongside if you can.
- bachmeier 5y ago
  These days it's becoming standard for any markdown converter to support katex/mathjax. For instance, markdown-it has markdown-it-katex. Dump your markdown with equations directly inside your html file and have it do the conversion. Or this: https://github.com/susam/texme https://github.com/susam/texme
  - 8HoLoN 5y ago
    Does it work on Github markdown ? (I made the tool back in 2019 mainly because I couldn't render latex in the render of the readme.md on Github)
    - oefrha 5y ago
      Not really, LaTeX is only supported in ipynb on GitHub AFAIK. The submission title is too generic though.
    - susam 5y ago
      Hello! I am the author of TeXMe[1]. Congratulations on launching a working project and running it successfully for the past few years. It is always nice to see new projects pertaining to rendering mathematics on the web. TeXMe does support GitHub Flavored Markdown (GFM)[2] when used in standalone HTML files. It however does not support your use case of rendering equations in GitHub README.md files. If TeXMe seems interesting, I would also request you to take a look at Muboard[4] which is a live, interactive, self-rendering mathematics chalkboard for the web built with TeXMe.[4] [1] https://github.com/susam/texme https://github.com/susam/texme [2] https://github.github.com/gfm https://github.github.com/gfm [3] https://spec.commonmark.org/ https://spec.commonmark.org/ [4] https://muboard.net/ https://muboard.net/
w4rh4wk5 5y ago
As an alternative, something that I've put together in the past for personal notes / documents. It also covers LaTeX (and TIKZ) inside Markdown and leverages Pandoc. https://github.com/W4RH4WK/Dogx https://github.com/W4RH4WK/Dogx It contains a Pandoc filter that pulls out the LaTeX code, generates an SVG that gets embedded into the resulting HTML document.
atishay811 5y ago
I hosted a small snippet on heroku and am using https://github.com/atishay/tex2svg/ https://github.com/atishay/tex2svg/ for my personal Hugo website. It is really cheap and easy to do latex to svg.
bArray 5y ago
Depending on your goal, I quite like using pandoc [1] for rendering math in HTML. I can write something like: Equation: $$x=\frac{1}{2}$$ Unfortunately there is no common in-browser Math rendering and as the referenced article points out, pictures of equations are not the solution [2]. A common mathematics rendering format is desperately needed but nobody really seems motivated to solve it. My approach is to use MathML that is rendered natively by Firefox and use JS to render in other browsers [3]. MathJax is way too heavy the last time I checked (growing towards 1MB) [4]. Instead I use math-ml, a JS library that is somewhat complete/abandoned but mostly works in about 80kB [5]. My rational for supporting Firefox's approach is that it's the browser I use, MathML is supported by W3C [6], MathML is supported by pandoc and there is a lightweight workaround for other browsers. [1] https://pandoc.org/ https://pandoc.org/ [2] https://danilafe.com/blog/math_rendering_is_wrong/ https://danilafe.com/blog/math_rendering_is_wrong/ [3] https://coffeespace.org.uk/projects/mathml-render.html https://coffeespace.org.uk/projects/mathml-render.html [4] https://www.mathjax.org/ https://www.mathjax.org/ [5] https://github.com/pshihn/math-ml https://github.com/pshihn/math-ml [6] http://www.w3.org/1998/Math/MathML http://www.w3.org/1998/Math/MathML
- IshKebab 5y ago
  I agree, I spent ages trying to find a Markdown solution that supported equations and images and so on. Pandoc was the only one that worked really well.

42 points by 8HoLoN 5y ago

I'm the author of the tool, I hope this will be useful to some of you in case you need to put mathematical formulas in your README.md

kzrdude 5y ago
Nice. There are unescaped ()'s in the URL, will this work correctly?
- 8HoLoN 5y ago
  It's seems to work with the parenthesis as is.
  - kzrdude 5y ago
    In all markdown parsers?

gus_massa 5y ago

Which packages does it support? I tried \cancel and it works :)

8HoLoN 5y ago
I don't really know, it's built over the latex.codecogs.com web services.

andreareina 5y ago

Is codecogs ok with you using their free service this way?

oefrha 5y ago

This just embeds an image from a third-party commercial service https://latex.codecogs.com/ https://latex.codecogs.com/. I don’t think this is a good idea. The “Buy Now” link on that site even 404s; I seriously doubt the longevity of that service. Just use Pandoc with good old KaTeX or MathJax. The CDN builds will last way longer than this commercial service, and you have the option of self-hosting everything. Edit: I didn't see the author's comment here. Apparently it's meant for environments where you aren't allowed to include your own JavaScript. In that case it's probably a good idea to prerender the images and include them alongside if you can.

bachmeier 5y ago
These days it's becoming standard for any markdown converter to support katex/mathjax. For instance, markdown-it has markdown-it-katex. Dump your markdown with equations directly inside your html file and have it do the conversion. Or this: https://github.com/susam/texme https://github.com/susam/texme
- 8HoLoN 5y ago
  Does it work on Github markdown ? (I made the tool back in 2019 mainly because I couldn't render latex in the render of the readme.md on Github)
  - oefrha 5y ago
    Not really, LaTeX is only supported in ipynb on GitHub AFAIK. The submission title is too generic though.
  - susam 5y ago
    Hello! I am the author of TeXMe[1]. Congratulations on launching a working project and running it successfully for the past few years. It is always nice to see new projects pertaining to rendering mathematics on the web. TeXMe does support GitHub Flavored Markdown (GFM)[2] when used in standalone HTML files. It however does not support your use case of rendering equations in GitHub README.md files. If TeXMe seems interesting, I would also request you to take a look at Muboard[4] which is a live, interactive, self-rendering mathematics chalkboard for the web built with TeXMe.[4] [1] https://github.com/susam/texme https://github.com/susam/texme [2] https://github.github.com/gfm https://github.github.com/gfm [3] https://spec.commonmark.org/ https://spec.commonmark.org/ [4] https://muboard.net/ https://muboard.net/

w4rh4wk5 5y ago

As an alternative, something that I've put together in the past for personal notes / documents. It also covers LaTeX (and TIKZ) inside Markdown and leverages Pandoc. https://github.com/W4RH4WK/Dogx https://github.com/W4RH4WK/Dogx It contains a Pandoc filter that pulls out the LaTeX code, generates an SVG that gets embedded into the resulting HTML document.

atishay811 5y ago

I hosted a small snippet on heroku and am using https://github.com/atishay/tex2svg/ https://github.com/atishay/tex2svg/ for my personal Hugo website. It is really cheap and easy to do latex to svg.

bArray 5y ago

Depending on your goal, I quite like using pandoc [1] for rendering math in HTML. I can write something like: Equation: $$x=\frac{1}{2}$$ Unfortunately there is no common in-browser Math rendering and as the referenced article points out, pictures of equations are not the solution [2]. A common mathematics rendering format is desperately needed but nobody really seems motivated to solve it. My approach is to use MathML that is rendered natively by Firefox and use JS to render in other browsers [3]. MathJax is way too heavy the last time I checked (growing towards 1MB) [4]. Instead I use math-ml, a JS library that is somewhat complete/abandoned but mostly works in about 80kB [5]. My rational for supporting Firefox's approach is that it's the browser I use, MathML is supported by W3C [6], MathML is supported by pandoc and there is a lightweight workaround for other browsers. [1] https://pandoc.org/ https://pandoc.org/ [2] https://danilafe.com/blog/math_rendering_is_wrong/ https://danilafe.com/blog/math_rendering_is_wrong/ [3] https://coffeespace.org.uk/projects/mathml-render.html https://coffeespace.org.uk/projects/mathml-render.html [4] https://www.mathjax.org/ https://www.mathjax.org/ [5] https://github.com/pshihn/math-ml https://github.com/pshihn/math-ml [6] http://www.w3.org/1998/Math/MathML http://www.w3.org/1998/Math/MathML

IshKebab 5y ago
I agree, I spent ages trying to find a Markdown solution that supported equations and images and so on. Pandoc was the only one that worked really well.