markdownify

Convert HTML to markdown.

markdownify Permissive license Active ★ 2,235 v1.2.3 released 2026-06-30

Install

markdownify on PyPI

pip

pip install markdownify

uv

uv add markdownify

poetry

poetry add markdownify

Package facts

License	not declared (permissive)
Python support	not specified
Install friction	low — pure-Python wheel
Runtime dependencies	2 — beautifulsoup4, six
Maintenance	actively maintained — 44 days since the last release
Last repo commit	2026-06-30
First released	2013-07-31
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: markdownify-1.2.3-py3-none-any.whl

Environment :: Web EnvironmentFramework :: DjangoIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 2.5Programming Language :: Python :: 2.6Programming Language :: Python :: 2.7Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Topic :: Utilities

About markdownify

from the package's own PyPI description — quoted content, verbatim

.. |build| image:: https://img.shields.io/github/actions/workflow/status/matthewwithanm/python-markdownify/python-app.yml?branch=develop :alt: GitHub Workflow Status :target: https://github.com/matthewwithanm/python-markdownify/actions/workflows/python-app.yml?query=workflow%3A%22Python+application%22

.. |version| image:: https://img.shields.io/pypi/v/markdownify :alt: Pypi version :target: https://pypi.org/project/markdownify/

.. |license| image:: https://img.shields.io/pypi/l/markdownify :alt: License :target: https://github.com/matthewwithanm/python-markdownify/blob/develop/LICENSE

.. |downloads| image:: https://pepy.tech/badge/markdownify :alt: Pypi Downloads :target: https://pepy.tech/project/markdownify

Installation

pip install markdownify

Usage

Convert some HTML to Markdown:

.. code:: python

from markdownify import markdownify as md
md('&lt;b&gt;Yay&lt;/b&gt; &lt;a href="http://github.com"&gt;GitHub&lt;/a&gt;')  # &gt; '**Yay** [GitHub](http://github.com)'

Specify tags to exclude:

.. code:: python

from markdownify import markdownify as md
md('&lt;b&gt;Yay&lt;/b&gt; &lt;a...

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Converts HTML markup to Markdown format, supporting customizable tag handling, heading styles, list formatting, and code block options through a BeautifulSoup-based parser.

Low friction: pure-Python wheel with only two runtime dependencies (beautifulsoup4 and six). Last release 44 days ago; repository active with 2235 stars and recent commits.

Permissive license (MIT per classifiers) allows commercial and private use with minimal restrictions, typical for widely-adopted utilities.

Usage

pip install markdownify

from markdownify import markdownify as md
result = md('<b>Yay</b> <a href="http://github.com">GitHub</a>')
print(result)  # '**Yay** [GitHub](http://github.com)'

Verdict: Mature, actively maintained utility with no known vulnerabilities and permissive licensing. Low install friction and top-1000 popularity make it a safe choice for HTML-to-Markdown conversion workflows. Extensive configuration options support both simple and specialized use cases.

Needs verification

Whether beautifulsoup4 and six are reliably maintained and have no unresolved security issues themselves
Python version support specifics—classifiers list 2.5–3.8 but requires_python is unspecified

html to markdown converterconvert html markdownhtml markdown transformationbeautifulsoup markdownhtml parser markdown outputweb scraping markdowncontent extraction markdown