---
id: types-markdown
version: "3.10.2.20260712"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-Markdown — Typing stubs for Markdown

License: permissive · Maintenance: active · Downloads: 17.7M/mo

## What it is and what it does

types-Markdown is a type stub package that bridges the Markdown library and static type checkers. It contains type annotations for the Markdown package, allowing tools like mypy (2.2.0) and pyright (1.1.411) to understand the types and signatures of Markdown's public API when analyzing code that imports and uses it.

This package is maintained as part of the typeshed project and is automatically generated from typeshed's stub definitions. It has no runtime dependencies and is installed purely to support development-time type checking. Once installed, type checkers will automatically discover and use the stubs to validate calls to Markdown functions and classes.

Use it for:

- Enable mypy or pyright to type-check code that calls Markdown library functions without false positives.
- Catch type errors in Markdown usage (e.g., passing wrong argument types) before runtime.
- Provide IDE autocomplete and inline type hints for Markdown APIs in editors that support type stubs.
- Validate Markdown integration in a larger typed codebase without modifying the Markdown library itself.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides type stubs for the Markdown package, enabling type checkers like mypy and pyright to validate code that uses Markdown.

Yes, if you use Markdown in a codebase with static type checking. Install it alongside mypy or pyright to eliminate type-checking blind spots in Markdown usage. No installation needed if you don't use a type checker or don't use the Markdown library.

## Install

pip install types-markdown
uv add types-markdown
poetry add types-markdown

## Installing types-Markdown

Before you install: Low install friction with no runtime dependencies. Maintained actively as part of the typeshed project, with recent updates.

License in practice: Licensed under Apache-2.0 (permissive), imposing no significant restrictions on use or redistribution.

Quickstart:

pip install types-Markdown

# Then use with mypy or pyright in your project
# mypy will automatically discover the stubs when checking code that imports markdown

Requires Python >=3.10; type checker (mypy, pyright, or similar) must be installed separately to use the stubs.

Verify before relying:

- Whether this stub package works with Markdown versions outside the ~=3.10.2 range it targets.
- Coverage completeness for all public Markdown APIs relative to the actual library.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 17.7M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

type stubs markdown, mypy markdown types, pyright markdown annotations, markdown type checking, typeshed markdown stubs, markdown type hints, static type checking markdown, type-stubs, type-checking

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