mdformat-space-control 0.1.3

An mdformat plugin for space control: EditorConfig indentation, tight lists, and frontmatter spacing.

mdformat-space-control

An mdformat plugin that provides unified control over Markdown spacing:

• EditorConfig support: Configure list indentation via .editorconfig files
• Tight list formatting: Automatically removes unnecessary blank lines between list items
• Frontmatter spacing: Normalizes spacing after YAML frontmatter (works with mdformat-frontmatter)
• Trailing whitespace removal: Strips trailing whitespace outside code blocks
• Escaped link repair: Fixes malformed multi-line links from web-clipped content

Installation

pip install mdformat-space-control

Or with pipx for command-line usage:

pipx install mdformat
pipx inject mdformat mdformat-space-control

Usage

After installation, mdformat will automatically use this plugin:

mdformat your-file.md

EditorConfig Support

Create an .editorconfig file in your project:

# .editorconfig
root = true

[*.md]
indent_style = space
indent_size = 4

Nested lists will use the configured indentation:

Before:

- Item 1
  - Nested item
- Item 2

After (with 4-space indent):

- Item 1
    - Nested item
- Item 2

Tight List Formatting

Lists with single-paragraph items are automatically formatted as tight lists:

Before:

- Item 1

- Item 2

- Item 3

After:

- Item 1
- Item 2
- Item 3

Multi-paragraph items preserve loose formatting:

- First item with multiple paragraphs

  Second paragraph of first item

- Second item

Frontmatter Spacing

When used with mdformat-frontmatter, this plugin removes blank lines between the frontmatter closing delimiter and the first content block:

Before:

---
title: My Document
---


# Introduction

After:

---
title: My Document
---
# Introduction

Install both plugins for this feature:

pip install mdformat-space-control mdformat-frontmatter

EditorConfig Properties

Property	Status	Notes
indent_style	Supported	space or tab for list indentation
indent_size	Supported	Number of spaces per indent level
tab_width	Supported	Used when indent_size = tab

Python API

When using the Python API, you can set the file context for EditorConfig lookup:

import mdformat
from mdformat_space_control import set_current_file

set_current_file("/path/to/your/file.md")
try:
    result = mdformat.text(markdown_text, extensions={"space_control"})
finally:
    set_current_file(None)

Compatible Plugins

This plugin is tested to work alongside:

• mdformat-frontmatter - YAML frontmatter parsing
• mdformat-wikilink - [[wikilink]] handling
• mdformat-simple-breaks - Line break handling

For formatting files in an Obsidian vault, installing mdformat-frontmatter and mdformat-wikilink alongside this plugin is recommended:

pip install mdformat-space-control mdformat-frontmatter mdformat-wikilink

Development

# Install dependencies
uv sync

# Run tests
uv run python -m pytest

# Run with coverage
uv run python -m pytest --cov=mdformat_space_control

License

MIT - see LICENSE file for details.