globalGroup documentation

I have two math blocks that I’d like to render

\newcommand\dfn{:=}
\newcommand\conj[1]{\overline{#1}}

a \dfn \conj{b}

and

a \dfn \conj{b}

The second block uses \newcommand definitions from the first.

I’m looping over the blocks via

katex.render(content, node, {
  displayMode: true,
  throwOnError: false,
  trust: true,
  globalGroup: true,
});

I’d been under the impression that globalGroup: true makes sure the \newcommands are global. However, from the above I’m getting

This is with KaTeX v0.15.2 on Chrome 98.0.4758.80.

Am I missing something?

[edemaine]

It’s weird that the example doesn’t actually include \def or \newcommand. I’m unsure now how this is supposed to work at all.

The example is outside the bullet; it’s meant to be an example of how to use katex.render in general. Perhaps there should be a heading like ### Example to clarify that. But I also think it would make sense to replace it with an example that actually creates a shared macros object, e.g.:

const macros = {};
katex.renderToString(..., {macros});
katex.render(..., element2, {macros});

And maybe include a \gdef (or \def and globalGroup) in the first example.

[KaTeX-bot]

🎉 This issue has been resolved in version 0.15.3 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀