py-markdown-table

What it is and what it does

py-markdown-table is a lightweight Python library that converts lists of dictionaries into formatted markdown tables. It takes uniform dictionaries (where all dicts have the same keys) and renders them as markdown-formatted tables with the dict keys becoming column headers and the values becoming rows.

The library offers granular control over table formatting through a chainable `set_params()` method, allowing you to configure row separators (always, topbottom, markdown, or none), per-column or global padding width and alignment (left, right, centerleft, centerright), custom padding and newline characters, float rounding precision, emoji spacing, and multiline column widths. It integrates easily with pandas by converting dataframes to dict records first.

Use it for:

• Generate markdown documentation tables from structured data programmatically
• Format API response data or database query results as readable markdown for reports
• Convert pandas DataFrames to markdown tables for embedding in markdown files or READMEs
• Create aligned, padded tables in CLI tools that output markdown-formatted text
• Build markdown tables with custom column widths and text wrapping for long content

Worth the install?

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

Generates formatted markdown tables from lists of dictionaries, with support for padding, alignment, multiline text, and float rounding.

Yes. Zero dependencies, active maintenance, permissive license, and broad Python version support (3.8–3.13) make it a low-risk choice. Install if you need to programmatically generate markdown tables from structured data; the formatting options are substantial enough for most use cases.

Install

py-markdown-table on PyPI

pip install py-markdown-table

uv add py-markdown-table

poetry add py-markdown-table

Installing py-markdown-table

Before you install

Low friction: pure Python wheel with zero runtime dependencies and active maintenance (last commit 2026-07-25). Supports Python 3.8 through 3.13.

License in practice

MIT license (permissive) places no restrictions on use, modification, or distribution.

Quickstart

pip install py-markdown-table

from py_markdown_table.markdown_table import markdown_table
data = [{"Product": "Smartphone", "Brand": "Apple", "Price": 999.99}]
markdown = markdown_table(data).get_markdown()
print(markdown)

Verify before relying

• Whether the package handles edge cases like empty data, None values, or non-uniform dict keys gracefully
• Performance characteristics with very large tables or deeply nested multiline content

Package facts

Evidence: py_markdown_table-1.3.0-py3-none-any.whl

Tags

More Markup packages