---
id: mdformat-tables
version: "1.0.0"
license: unclear
license_treatment: permissive
maintenance: abandoned
---

# mdformat_tables — An mdformat plugin for rendering tables.

License: permissive · Maintenance: abandoned · Downloads: 794.8K/mo

## 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 above — 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

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

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 794.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

markdown table formatter, mdformat plugin tables, align markdown tables, format markdown columns, markdown table alignment, markdown-formatting, mdformat-plugin

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