mdformat_editorconfig 0.1.0

An mdformat plugin for applying .editorconfig indentation settings.

mdformat-editorconfig

An mdformat plugin that applies EditorConfig indentation settings to Markdown formatting.

Motivation

mdformat uses opinionated defaults for indentation (2 spaces). This plugin allows you to configure indentation via .editorconfig files, making mdformat respect your project's or personal indentation preferences.

Installation

pip install mdformat-editorconfig

Or with pipx for command-line usage:

pipx install mdformat
pipx inject mdformat mdformat-editorconfig

Usage

Create an .editorconfig file in your project (or home directory):

# .editorconfig
root = true

[*.md]
indent_style = space
indent_size = 4

Then format your Markdown files as usual:

mdformat your-file.md

Example

With the above .editorconfig, nested lists will use 4-space indentation:

Before:

- Item 1
  - Nested item
- Item 2

After:

- Item 1
    - Nested item
- Item 2

Supported Properties

Property	Values	Description
indent_style	space, tab	Type of indentation
indent_size	integer	Number of columns per indentation level

How It Works

The plugin overrides mdformat's list renderers to apply indentation settings from .editorconfig files. It:

1. Looks up .editorconfig settings for the file being formatted
2. Reads indent_style and indent_size properties
3. Applies the configured indentation to list continuation lines and nested content

File Context

For the plugin to read .editorconfig settings, it needs to know the file path being formatted. When using the Python API directly with mdformat.text(), you can set the file context:

import mdformat
from mdformat_editorconfig import set_current_file

# Set the file context for editorconfig lookup
set_current_file("/path/to/your/file.md")
try:
    result = mdformat.text(markdown_text, extensions={"editorconfig"})
finally:
    set_current_file(None)

When no file context is set, the plugin passes through to mdformat's default behavior (2-space indentation).

Scope

This plugin currently handles indentation for:

• Bullet lists (unordered lists)
• Ordered lists

Code blocks and blockquotes follow CommonMark standard formatting (4-space indentation for indented code blocks).

Development

Setup

# Clone the repository
git clone https://github.com/jdmonaco/mdformat-editorconfig.git
cd mdformat-editorconfig

# Install development environment with uv
uv sync

Running Tests

# Run all tests
uv run pytest

# Run with coverage
uv run pytest --cov=mdformat_editorconfig

# Run tests verbosely
uv run pytest -v

License

MIT - see LICENSE file for details.