pytest-md-report

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 on this page — 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

pytest-md-report on PyPI

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

Evidence: pytest_md_report-0.8.0-py3-none-any.whl

Keywords: pytest, plugin, markdown

Tags

More Text Processing packages