---
id: pytest-md-report
version: "0.8.0"
license: MIT License
license_treatment: permissive
maintenance: active
---

# pytest-md-report — A pytest plugin to generate test outcomes reports with markdown table format.

License: permissive · Maintenance: active · Downloads: 398.5K/mo

## What it is and what it does

pytest-md-report is a pytest plugin that captures test execution results and formats them as markdown tables instead of the default pytest output. It runs as a pytest hook during test collection and reporting, generating a structured markdown file or stdout report that summarizes pass/fail/error/skip/xfail/xpass counts by file, function, or parameter.

The plugin integrates with pytest's standard execution flow and supports multiple output modes: file-based reports, GitHub Flavored Markdown flavor, verbosity levels (per-file, per-function, per-parameter), custom columns extracted from pytest marks, execution duration tracking, and filtering by test outcome. Configuration can be set via command-line flags or in pyproject.toml/setup.cfg. Its dependencies—pytablewriter for markdown table generation, tcolorpy for optional color output, and typepy for type handling—are all lightweight utilities.

Use it for:

- Generate test summary tables for CI/CD pipelines and post them to pull requests as status comments.
- Create readable test reports for stakeholders by rendering markdown tables with pass/fail counts per test file.
- Track test execution duration per test case and identify performance regressions across runs.
- Render custom test metadata (e.g., test IDs, priority levels) as columns in reports using pytest marks.
- Exclude specific test outcomes (passed, skipped, xpassed) from reports to focus on failures and errors.

## Worth the install?

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

A pytest plugin that generates test outcome reports formatted as markdown tables, with options for verbosity, custom columns from test marks, execution duration tracking, and multiple markdown flavors.

Yes. The plugin is actively maintained, has no security vulnerabilities, uses a permissive MIT license, and solves a concrete problem—converting pytest output into readable markdown tables for documentation and CI/CD workflows. Low install friction and broad Python version support (3.10–3.14) make it a straightforward addition to test infrastructure.

## Install

pip install pytest-md-report
uv add pytest-md-report
poetry add pytest-md-report

## Installing pytest-md-report

Before you install: Low friction: pure Python wheel with four runtime dependencies (pytablewriter, pytest, tcolorpy, typepy). Active maintenance, last commit 2026-07-20, no known vulnerabilities.

License in practice: MIT License (permissive): free to use, modify, and distribute with minimal restrictions. Suitable for both open-source and commercial projects.

Quickstart:

pip install pytest-md-report

pytest --md-report examples/

# With verbosity and custom output:
pytest --md-report --md-report-verbose=1 --md-report-output report.md examples/

Requires Python 3.10 or later; pytest must be installed in the same environment.

Verify before relying:

- Whether the plugin works with pytest plugins that also generate custom output or modify test collection.
- Performance impact when running large test suites with high verbosity or many custom mark columns.

## Package facts

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

## Tags

pytest markdown report generator, test results markdown table, pytest plugin reporting, markdown test summary, pytest outcome documentation, test report markdown format, pytest table output, pytest-plugin, test-reporting, ci-cd

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