---
id: markdownify
version: "1.2.3"
license: unclear
license_treatment: permissive
maintenance: active
---

# markdownify — Convert HTML to markdown.

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install markdownify
uv add markdownify
poetry add markdownify

## Description

|build| |version| |license| |downloads|

.. |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('<b>Yay</b> <a href="http://github.com">GitHub</a>')  # > '**Yay** [GitHub](http://github.com)'

Specify tags to exclude:

.. code:: python

    from markdownify import markdownify as md
    md('<b>Yay</b> <a...

## AI interpretation — verify before relying

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

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.

[View on SkillFed](https://skillfed.io/packages/markdownify) · [View on PyPI](https://pypi.org/project/markdownify/)