Markdown

Markdown auto-formatting tools mdformat:

• https://pypi.org/project/mdformat/0.5.1/

• https://mdformat.readthedocs.io/en/stable/users/installation_and_usage.html

link to mdformat tool documentation:

• https://mdformat.readthedocs.io/en/stable/users/style.html

2026-02-10 - Possible common localhost set up

A localhost can have multiple Python virtual environments. If a common way of using mdformat is desired it may make sense to create a `venv` in the localhost user's home directory, and to then install mdformat as follows:

 1022  python3 -m venv .venv
 1023  source ./.venv/bin/activate
 1025  pip install pipx
 1026  pipx install mdformat
 1027  pipx inject mdformat mdformat-gfm
 1028  history

Markdown Project Issues

Need for ignore directive with mdformat utility:

Markdown as formatting tool does not as of 2026 Q1 support "ignore block" directives. It formats the entire document. For single spaced bullet lists it concatenates each line and bullet point into a single line. Not helpful! A Github issue has been raised regarding this:

• https://github.com/hukkin/mdformat/issues/53