|0.5.0||Mar 4, 2023|
|0.4.4||Nov 7, 2022|
|0.4.2||Apr 24, 2022|
|0.3.1||Mar 6, 2022|
|0.1.3||Dec 31, 2016|
#35 in Text processing
6,008 downloads per month
Used in 43 crates (29 directly)
html2text is a Rust crate which converts HTML to plain text.
It makes use of the Servo project's HTML parser, html5ever, using the DOM to generate text (which can optionally include annotations for some features such as hyperlinks).
The project aims to do a reasonable job of rendering reasonable HTML in a terminal or other places where HTML needs to be converted to text (for example the text/plain fallback in HTML e-mails).
use html2text::from_read; let html = b" <ul> <li>Item one</li> <li>Item two</li> <li>Item three</li> </ul>"; assert_eq!(from_read(&html[..], 20), "\ * Item one * Item two * Item three ");
A couple of simple demonstration programs are included as examples:
The simplest example uses
from_read to convert HTML on stdin into plain
$ cargo run --example html2text < foo.html [...]
A very simple example of using the rich interface (
from_read_rich) for a
slightly interactive console HTML viewer is provided as
$ cargo run --example html2term foo.html [...]
Note that this example takes the HTML file as a parameter so that it can read keys from stdin.