Struct Math 

pub struct Math;

Render $...$ and $$...$$ math spans to MathML.

Two entry points:

• Math::preprocess_source runs before the dmc lexer; rewrites raw $...$ / $$...$$ to <MathMl mathml="..."/> JSX so the parser never sees unescaped LaTeX. Required: _ and ^ inside math would otherwise be parsed as Markdown emphasis markers.
• Transformer impl runs as a pipeline pass on already-parsed AST. Used by tests and any caller that builds a Document directly.

Implementations

impl Math

pub fn preprocess_source(source: &str) -> String

Rewrite $...$ / $$...$$ in raw MDX source to <MathMl/> JSX. Skips fenced code blocks, inline code spans, and existing JSX tags.

pub fn render(latex: &str, display: bool) -> String

Render a LaTeX string. Engine is the active crate::MathEngine (default KaTeX HTML; can be flipped to MathML via pulldown-latex). Cached by (latex, display, engine) so repeated math in a doc hits the renderer once. On parse failure returns a <span class="math-error"> wrapper around the original LaTeX.

pub fn set_engine(engine: MathEngine)

Process-wide active engine. Set once via Math::set_engine (pipeline does this from PipelineConfig::math_engine); defaults to KaTeX. Stored as a static so [render] does not need a per-call engine argument (keeps the source preprocessor signature engine-agnostic).

pub fn load_cache(path: &Path)

Load a previously persisted math cache from path. Silently ignores missing/corrupt files. Idempotent: existing in-memory entries are kept (cache wins are additive).

pub fn save_cache(path: &Path)

Persist the in-memory math cache to path. Best effort; errors are swallowed.

pub fn render_node(latex: &str, display: bool, span: &Span) -> Node

Render LaTeX as a self-closing <MathMl/> JsxSelfClosing node.

Trait Implementations

impl Debug for Math

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Math

fn default() -> Math

Returns the “default value” for a type.

impl Transformer for Math

fn name(&self) -> &str

Stable identifier for logging / error reporting.

fn transform( &self, doc: &mut Document, _meta: &SourceMeta, _engine: &mut DiagnosticEngine<Code>, )

Mutate doc in place. May be a no-op when preconditions (config, environment, feature flags) aren’t met.