Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Use KaTeX instead of MathJax #280

Open
ggrossetie opened this issue Mar 31, 2019 · 4 comments
Open

Use KaTeX instead of MathJax #280

ggrossetie opened this issue Mar 31, 2019 · 4 comments

Comments

@ggrossetie
Copy link
Member

MathJax is great but the rendering is a bit slow and the complete bundle size is roughly 5 Mb... As an alternative we could use KaTex: https://katex.org/docs/browser.html

@mojavelinux
Copy link
Member

What I would recommend is making the switch and seeing what kind of feedback you get from users. If there are a lot of complaints about KaTeX, then you could consider making it an option, like stem-engine.

We may want to agree on how this integrates into core, then do it here.

@bybor
Copy link

bybor commented Feb 1, 2022

AFAIK, KaTeX doesn't support AsciiMath, while MathJax does (at least MJ version 2 does support it).

I don't know what you pick, but this extension is a very nice and pretty easy way to render a local asciidoc file.

I don't know if you can cache MJ lib locally to address its size issue. Or if it comes with extension in the same bundle?

But I would vote for universality vs other considerations.

Thank you!!!

@ggrossetie
Copy link
Member Author

I don't know if you can cache MJ lib locally to address its size issue. Or if it comes with extension in the same bundle?

It comes with the extension in the same bundle.
This is just a proposal, KaTeX looks great on paper but, as you mentioned, lacks some features so we will probably stick with MathJax.

@rben01
Copy link

rben01 commented Mar 14, 2023

I much prefer KaTeX to MathJax — I find it is faster and produces nicer-looking output. I'd be in favor of a stem-engine attribute, or perhaps adding latexmath-mathjax and latexmath-katex as options to :stem:.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants