Math engine support ($$ $$)

[glebm]

Kramdown provides math engine support, via $$ (block) and $ (inline).

Implementing an engine is fairly simple. For example, here is my KaTeX implementation: https://github.com/gettalong/kramdown/blob/master/lib/kramdown/converter/math_engine/katex.rb

Is this possible with commonmarker and if so, how?

[gjtorikian]

Thanks for the feedback.

I think we are going to explicitly keep this gem bound to the Commonmark spec.

However, please consider using https://github.com/gjtorikian/mathematical, which parses LaTeX symbols and converts them into math-rendered SVGs. You could tie this up with something like https://github.com/jch/html-pipeline to provide a full pass conversion.

Alternative, you are free to create your own custom renderer as a plugin/add-on: https://github.com/gjtorikian/commonmarker#creating-a-custom-renderer

I just want to keep this gem in particular specific to the spec.

[glebm]

However, please consider using gjtorikian/mathematical,

I'm not looking for a particular math engine.

You could tie this up with something like jch/html-pipeline to provide a full pass conversion.

A solution involving html-pipeline is bound to have quirky edge cases. Consider that: markdown inside $$ should not be processed; $$ inside a code-block should not be processed as math; etc.

Alternative, you are free to create your own custom renderer as a plugin/add-on: gjtorikian/commonmarker#creating-a-custom-renderer

Yes, this is my question. How would I define a custom renderer for $$ $$ / $ $?

There is a lot of results for "math" on CommonMark Discourse: https://talk.commonmark.org/search?q=math

Some of them mention extensions and no-markdown islands but I don't know if any of that was ever implemented. GitLab recently switch to CommonMark and they work around the issue by requiring math tags to be wrapped in backticks:

https://github.com/gitlabhq/gitlabhq/blob/04845fdeae75ba5de7c93992a5d55663edf647e0/lib/banzai/filter/math_filter.rb#L7

Is the custom renderer API powerful enough to support this use case?

[j7168908jx]

As requested by my boss, I've patched a little to support part of LaTeX math equations (using directly $ ... $ and $$ ... $$). If anyone is interested, please see my forked repo: https://github.com/j7168908jx/commonmarker

[gjtorikian]

Honestly that's really cool. You should ask the Commonmark folks to include this as an extension in the spec.