marco-core 1.0.2

nom-based Markdown parser, HTML renderer, and intelligence features (highlights, diagnostics, completions) for the Marco editor.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

use katex::{
    render_to_string as katex_render, KatexContext, OutputFormat, Settings as KatexSettings,
};
use std::sync::OnceLock;

// Global KaTeX context (reused across renders for performance)
static KATEX_CONTEXT: OnceLock<KatexContext> = OnceLock::new();

/// Render inline math using KaTeX.
pub(crate) fn render_inline_math(latex: &str) -> Result<String, Box<dyn std::error::Error>> {
    let ctx = KATEX_CONTEXT.get_or_init(KatexContext::default);
    let settings = KatexSettings::builder()
        .output(OutputFormat::Mathml)
        .build();
    let html = katex_render(ctx, latex, &settings)?;
    Ok(html)
}

/// Render display math using KaTeX.
pub(crate) fn render_display_math(latex: &str) -> Result<String, Box<dyn std::error::Error>> {
    let ctx = KATEX_CONTEXT.get_or_init(KatexContext::default);
    let settings = KatexSettings::builder()
        .display_mode(true)
        .output(OutputFormat::Mathml)
        .build();
    let html = katex_render(ctx, latex, &settings)?;
    Ok(html)
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn smoke_test_render_inline_math() {
        let html = render_inline_math("E = mc^2").expect("inline math should render");
        assert!(html.contains("<math") || html.contains("katex"));
    }

    #[test]
    fn smoke_test_render_display_math() {
        let html = render_display_math(r"\\frac{a}{b}").expect("display math should render");
        assert!(html.contains("<math") || html.contains("katex"));
    }
}