Editorjs2html

A Rust library that converts Editor.js output into clean HTML with semantic CSS classes.

Features

• Comprehensive support for Editor.js block types
• Clean HTML output with semantic CSS classes
• URL validation and HTML escaping for security
• Efficient string handling and memory usage
• Highly configurable styling options
• Built-in accessibility features

Installation

cargo add editorjs2html

Quick Start

use editorjs2html::string_to_html;

fn main() {
    let content = r#"{
        "blocks": [{
            "type": "header",
            "data": {
                "text": "Hello World",
                "level": 2
            }
        }]
    }"#;
    
    let html = string_to_html(content).unwrap();
    println!("{}", html);
}

Supported Block Types

Block-Specific Details

Alert Types

Available classes for alerts:

• js-alert-primary
• js-alert-secondary
• js-alert-info
• js-alert-success
• js-alert-warning
• js-alert-danger
• js-alert-light
• js-alert-dark

Image Modifiers

Additional classes for images:

• js-image--stretched - Full width
• js-image--bordered - With border
• js-image--background - With background

Inline Text Formatting

Applied in this order:

1. bold → <b>
2. italic → <i>
3. underline → <u>
4. marker → <mark>
5. inline_code → <code>

Styling

The library generates semantic HTML with consistent class names for styling. Example:

/* Headers */
.js-head h2 {
    color: #2c3e50;
    margin: 1.5em 0 1em;
}

/* Lists */
.js-list {
    padding-left: 1.5em;
}

/* Code blocks */
.js-code {
    background: #f8f9fa;
    padding: 1em;
    border-radius: 4px;
}

Contributing

1. Install development tools:

cargo install just
just setup

2. Commit messages must follow the format:

<type>: <description>

Types:
- feat:  New features
- fix:   Bug fixes
- docs:  Documentation
- style: Code style changes
- ref:   Refactoring
- test:  Testing
- perf:  Performance

3. Submit a pull request

License

Licensed under either:

• Apache License, Version 2.0
• MIT license

at your option.