pytest-md-report
A pytest plugin to generate test outcomes reports with markdown table format.
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; pytest must be installed in the same environment.
- Low friction: pure Python wheel with four runtime dependencies (pytablewriter, pytest, tcolorpy, typepy).
- Active maintenance, last commit 2026-07-20, no known vulnerabilities.
License · maintenance · safety
MIT License (permissive) — MIT License (permissive): free to use, modify, and distribute with minimal restrictions. Suitable for both open-source and commercial projects.
last release 2026-05-04 (102 days) · last repo commit 2026-07-20 · 63 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 398,484 downloads/mo, #6,953 on PyPI
Alternatives
Verify before relying
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/- 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.
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 on it.
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
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.
Requires Python 3.10 or later; pytest must be installed in the same environment.
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/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 the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 4 packagespytablewriterpytesttcolorpytypepy |
| Maintenance | Actively maintained 102 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 398,484 / month, #6,953 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaEnvironment :: PluginsFramework :: PytestIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Software Development :: Quality AssuranceTopic :: Software Development :: TestingTopic :: Text ProcessingTopic :: Text Processing :: Markup :: MarkdownTyping :: Typed |
Evidence: pytest_md_report-0.8.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “test results markdown table”
- pytest-md-reportA pytest plugin that generates test outcome reports formatted as…
- py-markdown-tableGenerates formatted markdown tables from lists of dictionaries, with…
- pytest-mdGenerates Markdown test reports from pytest test runs, summarizing…
Give your agent the search over MCP, or paste the wish link into any chat.
More Text Processing packages
A drop-in replacement for Python's standard `re` module that adds advanced regex features like nested sets, fuzzy matching, lookaround in conditionals, and full Unicode case-folding while maintaining backward compatibility.
pyparsing provides a library for building text parsers directly in Python code using composable grammar classes, handling quoted strings, whitespace variation, and embedded comments without regex or lex/yacc.
Install it if you need to parse text or define grammars programmatically.
fonttools manipulates font files in multiple formats (TrueType, OpenType, AFM, Type 1, Mac-specific) and includes TTX, a tool to convert fonts to and from XML text format.
Install it if you need to read, write, or manipulate fonts programmatically or via the TTX command-line tool.
Docutils converts plaintext documentation in reStructuredText format into multiple output formats including HTML, XML, and LaTeX using a modular processing system.
RapidFuzz provides fast fuzzy string matching using Levenshtein Distance and related metrics, implemented mostly in C++ with Python bindings for rapid similarity scoring and approximate string matching.
Install it if you need fuzzy string matching; it's a solid replacement for FuzzyWuzzy with better licensing and performance.
tinycss2 parses CSS strings into token and block objects, and generates CSS strings from those objects, following the CSS Syntax Level 3 specification without enforcing specific properties or values.
Install it if your project requires CSS tokenization or syntax manipulation.
See also pytest-md · pytest-html · pytest-custom-report · pytest-pretty · pytest-github-actions-annotate-failures · pytest-excel · pytest-csv · pytest-reportlog · pytest-json-report · pytest-progress