Skip to content

html2text

1,357 7 94 GNU GPL 3
2020.1.16 (16 Jan 2020) Dec 14 2008 1.2 million (month)

html2text is a Python library that allows developers to convert HTML code into plain text. It is designed to be easy to use, and it provides several options to customize the output.

The package uses the python's built-in html.parser to parse the HTML and then convert it to plain text.

html2text also comes with a CLI tool that can convert HTML files to text:

Usage: html2text [filename [encoding]]

Option  Description
--version   Show program's version number and exit
-h, --help  Show this help message and exit
--ignore-links  Don't include any formatting for links
--escape-all    Escape all special characters. Output is less readable, but avoids corner case formatting issues.
--reference-links   Use reference links instead of links to create markdown
--mark-code Mark preformatted and code blocks with [code]...[/code]

Example Use


import html2text

h = html2text.HTML2Text()

# Ignore converting links from HTML
h.ignore_links = True
print h.handle("<p>Hello, <a href='https://www.google.com/earth/'>world</a>!")
"Hello, world!"

print(h.handle("<p>Hello, <a href='https://www.google.com/earth/'>world</a>!"))

"Hello, world!"

# Don't Ignore links anymore, I like links
h.ignore_links = False
print(h.handle("<p>Hello, <a href='https://www.google.com/earth/'>world</a>!"))
"Hello, [world](https://www.google.com/earth/)!"

Alternatives / Similar


783 1.4.1 (a month ago) Jul 17 2019 compare
2,222 0.8.1 (2 years ago) Jun 30 2011 compare
12,488 0.2.8 (4 years ago) Dec 28 2012 compare
733 0.14.0 (4 months ago) Oct 27 2015 compare
3,063 0.11.0 (4 months ago) Oct 20 2013 compare
9,417 1.1.9 (4 years ago) Aug 24 2018 compare
74 2.0.7 (3 months ago) Dec 11 2020 compare

Other Languages

2,090 v1.2.0 (26 days ago) Apr 20 2016 compare