---
id: pytest-md
version: "0.2.0"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# pytest-md — Plugin for generating Markdown reports for pytest results

License: permissive · Maintenance: abandoned · Downloads: 737.2K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 737.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pytest markdown report generator, pytest test report markdown, generate markdown from pytest results, pytest output to markdown, markdown test summary, pytest report formatting, test results documentation, test-reporting, markdown-output

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