mdformat_tables

What it is and what it does

mdformat-tables extends mdformat, a Markdown formatter, with the ability to render and align Markdown tables. When you run mdformat on a file containing tables, this plugin reformats them by padding cells and aligning columns so that rows line up visually—converting compact, hard-to-read table syntax into a clean, uniform layout.

The package depends on mdformat (the core formatter) and wcwidth (for calculating column widths). It is a narrow, single-purpose tool: if you use mdformat and want your tables automatically formatted as part of your Markdown workflow, this plugin does that. However, the project is archived and no longer maintained, so it will not receive updates for new mdformat versions or Python releases.

Use it for:

• Automatically format Markdown tables in documentation files as part of a pre-commit or CI pipeline using mdformat.
• Align table columns in README or wiki files to improve readability without manual editing.
• Standardize table formatting across a repository of Markdown documents in a single mdformat run.

Worth the install?

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

mdformat-tables is a plugin for mdformat that automatically formats Markdown tables by aligning columns and padding cells for consistent spacing.

Yes, if you actively use mdformat and need table formatting—the plugin is lightweight and has no known vulnerabilities. However, be aware that the package is archived and abandoned; if mdformat introduces breaking changes or you need ongoing support, you may face compatibility issues. For new projects, verify that it works with your mdformat version before committing to it.

Install

mdformat-tables on PyPI

pip install mdformat-tables

uv add mdformat-tables

poetry add mdformat-tables

Installing mdformat_tables

Before you install

Installation is straightforward with low friction—only two runtime dependencies (mdformat and wcwidth). However, the package is archived and abandoned as of 721 days since its last release, so expect no future maintenance or bug fixes.

License in practice

Licensed under MIT (permissive), so you can use, modify, and distribute it freely with minimal restrictions.

Quickstart

pip install mdformat-tables

# Then use mdformat with the plugin enabled:
mdformat --plugins mdformat.plugins.tables your_file.md

Requires Python >=3.7.0 and mdformat to be installed; the plugin activates automatically once installed if mdformat is present.

Verify before relying

• Whether the plugin remains compatible with recent mdformat versions despite the package being archived.
• Whether wcwidth dependency has any known issues or security concerns not captured in the fact sheet.

Package facts

Evidence: mdformat_tables-1.0.0-py3-none-any.whl

Keywords: mdformat, markdown, markdown-it

Tags

More Python Modules packages