pytest-md

What it is and what it does

pytest-md is a pytest plugin that converts test results into a Markdown-formatted report. When you run pytest with the `--md` flag and a filename, it generates a summary document listing the number of passed, failed, skipped, xfailed, xpassed, and errored tests, along with a timestamp. The report can optionally include emojis if pytest-emoji is also installed.

The package is straightforward: it hooks into pytest's reporting system and writes a formatted Markdown file instead of (or alongside) the default terminal output. It's designed for teams that want to archive or share test results in a readable, version-control-friendly format.

Use it for:

• Archive test results as Markdown files in CI/CD pipelines for historical tracking and review.
• Generate human-readable test summaries to share with non-technical stakeholders or in pull request comments.
• Include test reports in documentation or project wikis by embedding the generated Markdown.
• Create a lightweight alternative to HTML reports when Markdown is preferred for version control or simplicity.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Generates Markdown test reports from pytest test runs, summarizing pass/fail/skip/error outcomes in a formatted document.

No. The package is abandoned (last update 2020-07-16) and will not receive maintenance or compatibility fixes. While it may still work with older pytest versions, relying on it for new projects risks incompatibility with current and future pytest releases. Consider pytest-html or other actively maintained reporting plugins instead.

Install

pytest-md on PyPI

pip install pytest-md

uv add pytest-md

poetry add pytest-md

Installing pytest-md

Before you install

Low install friction with a single runtime dependency on pytest. However, the package is abandoned—last release was 2019-07-11 and last commit 2020-07-16—so it will not receive bug fixes or compatibility updates for newer pytest versions.

License in practice

MIT license permits free use, modification, and distribution with minimal restrictions, making it safe for most projects from a licensing perspective.

Quickstart

pip install pytest-md

pytest --md report.md

# Generates report.md with test summary in Markdown format

Requires pytest to be installed. Package is abandoned and may not work with pytest versions released after 2020.

Verify before relying

• Compatibility with pytest versions released after 2020-07-16 is unknown.
• Whether the package works correctly with Python 3.8+ (released after the last update) is not documented in the fact sheet.

Package facts

Evidence: pytest_md-0.2.0-py3-none-any.whl

Keywords: pytest, markdown

Tags

More Testing packages