🧊 Frostmark

An HTML + Markdown viewer for iced

Render rich text in your iced app at lightning-fast speeds using plain HTML or Markdown!

Usage

1. Create a MarkState and store it in your application state.

use frostmark::MarkState;

let text = "Hello from **markdown** and <b>HTML</b>!";

let state = MarkState::with_html_and_markdown(text);
// or if you just want HTML
let state = MarkState::with_html(text);
// put this in your App struct

2. In your view function use a MarkWidget.

iced::widget::container( // just an example
    MarkWidget::new(&self.mark_state)
)
.padding(10)

Example

You can find runnable examples here

use frostmark::{MarkState, MarkWidget};
use iced::{widget, Element, Task};

#[derive(Debug, Clone)]
enum Message {}

struct App {
    state: MarkState,
}

impl App {
    fn update(&mut self, _: Message) -> Task<Message> {
        Task::none()
    }

    fn view(&self) -> Element<'_, Message> {
        widget::container(MarkWidget::new(&self.state))
            .padding(10)
            .into()
    }
}

fn main() {
    iced::application("Hello World", App::update, App::view)
        .run_with(|| {
            (
                App {
                    state: MarkState::with_html_and_markdown(YOUR_TEXT),
                },
                Task::none(),
            )
        })
        .unwrap();
}

const YOUR_TEXT: &str = "Hello from **markdown** and <b>HTML</b>!";

Note: Markdown support is optional and you can disable the markdown feature to have more lightweight, HTML-only support.

How does this work

• Markdown (if present) is converted to HTML using comrak.
• HTML is parsed using html5ever, from the Servo project.
• The resulting DOM is rendered directly to iced widgets using a custom renderer.

No custom widget types - everything is built from standard iced components like: column, row, rich_text, button, horizontal_bar, etc.

Rendering happens right inside impl Into<Element> for MarkWidget.

Crate Features

• markdown ✅: Adds markdown support alongside HTML
• iced-tiny-skia ✅: Enables iced tiny-skia rendering backend
• iced-wgpu ✅: Enables iced wgpu rendering backend

✅: enabled by default

Roadmap

• Update to iced 0.14
• Support for more elements (eg: superscript, table)

Contributing

This library is experimental. Bug reports and pull requests are welcome; contributions are appreciated!

• License: Dual licensed under MIT and Apache 2.0.