html-generator 0.0.5

A robust Rust library designed for transforming Markdown into SEO-optimized, accessible HTML. Featuring front matter extraction, custom header processing, table of contents generation, and performance optimization for web projects of any scale.
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

// SPDX-License-Identifier: Apache-2.0 OR MIT
// Copyright (c) 2025 HTML Generator. All rights reserved.

//! Custom Markdown extensions: triple-colon blocks and image classes.
//!
//! Demonstrates `:::class ... :::` styled blocks and
//! `![alt](url).class="cls"` image syntax.
//!
//! Run: `cargo run --example custom_syntax`

#[path = "support.rs"]
mod support;

use html_generator::{generate_html, HtmlConfig};

fn main() {
    support::header("html-generator -- custom_syntax");

    // ── Triple-colon class blocks ───────────────────────────────────
    support::task_with_output(
        "Triple-colon styled block (:::warning)",
        || {
            let md = ":::warning\n**Caution:** This action is irreversible.\n:::";
            let html =
                generate_html(md, &HtmlConfig::default()).unwrap();
            vec![
                format!(
                    "has class=warning = {}",
                    html.contains("class=\"warning\"")
                ),
                format!(
                    "has <strong>      = {}",
                    html.contains("<strong>")
                ),
            ]
        },
    );

    // ── Multiple block classes ──────────────────────────────────────
    support::task_with_output("Multiple styled blocks", || {
        let md = ":::note\nThis is a note.\n:::\n\n:::danger\nThis is dangerous.\n:::";
        let html = generate_html(md, &HtmlConfig::default()).unwrap();
        vec![
            format!(
                "has class=note   = {}",
                html.contains("class=\"note\"")
            ),
            format!(
                "has class=danger = {}",
                html.contains("class=\"danger\"")
            ),
        ]
    });

    // ── Image with custom class ─────────────────────────────────────
    support::task_with_output("Image with .class syntax", || {
        let md = r#"![Photo](photo.jpg).class="img-fluid rounded""#;
        let config = HtmlConfig {
            allow_unsafe_html: true,
            ..HtmlConfig::default()
        };
        let html = generate_html(md, &config).unwrap();
        vec![
            format!("has img-fluid = {}", html.contains("img-fluid")),
            format!("has alt=Photo = {}", html.contains("Photo")),
        ]
    });

    // ── Mixed custom syntax ─────────────────────────────────────────
    support::task_with_output(
        "Mixed: block + image + standard markdown",
        || {
            let md = "\
:::info\nCheck the **docs** for details.\n:::\n\n\
# Heading\n\n\
Regular paragraph.\n";
            let html =
                generate_html(md, &HtmlConfig::default()).unwrap();
            vec![
                format!(
                    "has class=info = {}",
                    html.contains("class=\"info\"")
                ),
                format!("has <h1>       = {}", html.contains("<h1>")),
                format!("has <p>        = {}", html.contains("<p>")),
            ]
        },
    );

    support::summary(4);
}