# Python-Markdown/markdown

A Python implementation of John Gruber’s Markdown with Extension support.

Repository: https://github.com/Python-Markdown/markdown
Canonical: https://ross.abutalabs.com/products/markdown
Homepage: https://python-markdown.github.io/
Language: Python
License: BSD-3-Clause
License Family: permissive
Topics: python-markdown, markdown, markdown-parser, markdown-to-html, python, python3
Last push: 2026-08-24T18:11:36+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 83, longevity 100
- inputs: {"age_days": 5940, "days_push": 9, "days_rel": 34, "gap_med": 68, "n_releases_24m": 8}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4239, forks 903 (observed 2026-08-28T04:08:39.603859+00:00)

## What it is
Python-Markdown is a Python implementation of John Gruber's Markdown that converts Markdown text to HTML, nearly compliant with the original reference implementation. It includes an Extension API for customizing or extending parser behavior, plus an optional CLI wrapper.

## Use cases
- convert markdown to html in python
- render markdown on a web server
- parse markdown files into html
- extend markdown syntax with custom extensions
- markdown converter command line tool
- render user-generated markdown content safely in a web app

## When to choose
- you need a mature, well-documented Python markdown parser
- you want to follow the original markdown.pl behavior rather than CommonMark
- you need an extension API to add custom syntax
- you need Unicode/international input support

## When to avoid
- you require strict CommonMark compliance
- you need extremely high-performance parsing of huge documents
- you are not working in Python

## Facets
- artifact type: library
- maturity: stable
- function: parser, markdown, cli, templating
- domain: web-development, documentation, developer-tools, parsers
- platform: python, cli, cross-platform
- tags: markdown-to-html, markdown-parser, extension-api, text-processing

## Member repositories
- Python-Markdown/markdown (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:39.603859+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:22:15.913301+00:00, confidence not recorded.
  - readme: https://github.com/Python-Markdown/markdown (fetched 2026-08-28T04:08:39.603859+00:00, sha c4284dac2103)
  - homepage: https://python-markdown.github.io/ (fetched 2026-08-29T09:12:07.933485+00:00, sha 8eff036fedcd)
  - registry_pypi: https://pypi.org/pypi/markdown/json (fetched 2026-08-29T09:12:07.936284+00:00, sha bade347195ce)
- Data as of 2026-08-30T08:39:29.467469+00:00.