Supported environments¶

Python versions¶

The minimum version is Python 3.10 because the plugin uses str.removeprefix() and structural pattern matching internally.

Version	Status
9.0+	Supported (subtests built-in)
< 9.0	Not supported

pytest 9.0 is the minimum version. It introduced built-in subtests support, which markdown-pytest relies on for the case: feature.

Tested on Linux, macOS, and Windows. Path handling uses pathlib throughout, so cross-platform behaviour is consistent.

Required for async tests (name: async test_...).

pip install "markdown-pytest[async]"
# equivalent to:
pip install markdown-pytest pytest-asyncio

Compatible versions: pytest-asyncio >= 1, < 2.

Any pytest plugin that can run async def test functions works:

Without an async plugin, async tests fail immediately with a clear error message.

Tracebacks from failing tests preserve the original Markdown line numbers. A failure in a code block at line 42 of README.md reports:

README.md:42: AssertionError

This works because the plugin compiles code with filename=<path> and inserts blank lines to pad line numbers to match the Markdown source.

markdown-pytest is compatible with:

The plugin registers itself via the pytest11 entry point:

[project.entry-points.pytest11]
markdown-pytest = "markdown_pytest"

No conftest.py import or pytest_plugins declaration is needed. Install the package and pytest finds the plugin automatically.