Crate highlight_pulldown

Source
Expand description

§Highlight Pulldown Code

A small library crate to apply syntax highlighting to markdown parsed with pulldown-cmark.

The implementation is based on the discussion at pulldown-cmark#167.

§Usage

The crate exposes a single function, highlight. It takes an iterator over pulldown-cmark events and returns a corresponding Vec<pulldown_cmark::Event> where code blocks have been substituted by HTML blocks containing highlighted code.

use highlight_pulldown::highlight_with_theme;

let markdown = r#"
```rust
enum Hello {
    World,
    SyntaxHighlighting,
}
```"#;
let events = pulldown_cmark::Parser::new(markdown);

// apply a syntax highlighting pass to the pulldown_cmark events
let events = highlight_with_theme(events, "base16-ocean.dark").unwrap();

// emit HTML or further process the events as usual
let mut html = String::new();
pulldown_cmark::html::push_html(&mut html, events.into_iter());

For better efficiency, instead of invoking highlight or highlight_with_theme in a hot loop consider creating a PulldownHighlighter object once and use it many times.

§Contributing

If you happen to use this package, any feedback is more than welcome.

Contributions in the form of issues or patches via the GitLab repo are even more appreciated.

Structs§

PulldownHighlighter

Enums§

Error

Functions§

highlight
Apply syntax highlighting to pulldown-cmark events using the default theme.
highlight_with_theme
Apply syntax highlighting to pulldown-cmark events using the specified theme.