Skip to main content

mdformat-lists

Build Status codecov PyPI version PyPI Supported Python Versions

A mdformat plugin to configure list markers for unordered and ordered lists.

By default, mdformat uses - as the bullet character (alternating with * for consecutive lists) and . as the ordered list marker. This plugin allows you to choose between -, *, and + for bullets, and . and ) for ordered list markers.

Usage

Install with:

pip install mdformat-lists

Then simply run mdformat as usual:

mdformat <filename>

Configuration

Unordered list bullet

Configure the bullet character in .mdformat.toml:

[plugin.lists]
bullet = "*"

Or via the command line:

mdformat --bullet="*" <filename>

Valid values are - (default), *, and +.

Ordered list marker

Configure the ordered list marker in .mdformat.toml:

[plugin.lists]
ordered_marker = ")"

Or via the command line:

mdformat --ordered-marker=")" <filename>

Valid values are . (default) and ).

When multiple ordered lists appear consecutively, the plugin alternates between the primary and secondary marker (. and )) to prevent Markdown parsers from merging separate lists into one.

Contributing

Pull requests are welcome.

Development

Prerequisites: mise

git clone https://github.com/brendanmaguire/mdformat-lists.git
cd mdformat-lists
mise trust && mise install

Run tasks with mise, for example mise unit-test.

Metadata

Release files for mdformat-lists 0.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mdformat-lists 0.0.3
File Size Uploaded Provenance
mdformat_lists-0.0.3.tar.gz 28.9 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for mdformat-lists 0.0.3
File Interpreter ABI Platform
mdformat_lists-0.0.3-py3-none-any.whl Python 3 none any Details

Total release size: 33.8 kB

Release files / mdformat_lists-0.0.3.tar.gz

Download URL mdformat_lists-0.0.3.tar.gz
Size 28.9 kB
Tags Source
SHA-256 checksum
How to use checksums
357b899f339d2356aaf1563642ca683c4f9541a6c25cf543796b105002303c82
BLAKE2b-256 checksum
How to use checksums
c00fd57f217c797db71d76f50717359edb5bd989db4b90789f5046b5ec6b4ef3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Feb 26, 2026.

Transparency log

Release files / mdformat_lists-0.0.3-py3-none-any.whl

Download URL mdformat_lists-0.0.3-py3-none-any.whl
Size 4.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a795e40abdf5de3e078efde72bd2ee3a0dd92dd86baa24dde7e88ca4f5e98255
BLAKE2b-256 checksum
How to use checksums
79e7e68ac4010c6026a041071d05e20f02152fba996433c05b9d8ddd8d7311f4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Feb 26, 2026.

Transparency log

Security for mdformat-lists 0.0.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for mdformat_lists-0.0.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Feb 26, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page