#426 Committing to Formatted Markdown
29:18 Share

Topics covered in this episode:

- [**mdformat**](https://github.com/hukkin/mdformat?featured_on=pythonbytes))

• pre-commit-uv)

• PEP 758 and 781

• Serie): rich git commit graph in your terminal, like magic

• Extras

• Joke

Watch on YouTube)

About the show

Sponsored by Posit Connect Cloud: pythonbytes.fm/connect-cloud)

Connect with the hosts

• Michael: @[email protected]) / @mkennedy.codes) (bsky)

• Brian: @[email protected]) / @brianokken.bsky.social)

• Show: @[email protected]) / @pythonbytes.fm) (bsky)

Join us on YouTube at pythonbytes.fm/live) to be part of the audience. Usually Monday at 10am PT. Older video versions available there too.

Finally, if you want an artisanal, hand-crafted digest of every week of the show notes in email form? Add your name and email to our friends of the show list), we'll never share it.

Brian #1: mdformat)

• Suggested by Matthias Schöttle

• Last episode )Michael covered blacken-docs, and I mentioned it’d be nice to have an autoformatter for text markdown.

• Matthias delivered with suggesting mdformat

• “Mdformat is an opinionated Markdown formatter that can be used to enforce a consistent style in Markdown files.”

• A python project that can be run on the command line.

• Uses a style guide) I mostly agree with.

• I’m not a huge fan of numbered list items all being “1.”, but that can be turned off with --number, so I’m happy.

• Converts underlined headings to #, ##, etc. headings.

• Lots of other sane conventions.

• The numbering thing is also sane, I just think it also makes the raw markdown hard to read.

• Has a plugin system to format code blocks)

Michael #2: pre-commit-uv)

• via Ben Falk

• Use uv to create virtual environments and install packages for pre-commit.

Brian #3: PEP 758 and 781

• PEP 758 – Allow except and except* expressions without parentheses)

• accepted

• PEP 781 – Make TYPE_CHECKING a built-in constant)

• draft status

• Also, PEP Index by Category )kinda rocks

Michael #4: Serie): rich git commit graph in your terminal, like magic

• While some users prefer to use Git via CLI, they often rely on a GUI or feature-rich TUI to view commit logs.

• Others may find git log --graph sufficient.

• Goals

• Provide a rich git log --graph experience in the terminal.

• Offer commit graph-centric browsing of Git repositories.

Extras

Michael:

• Sunsetting Search)? (Startpage))

• Ruff in or out)?

Joke: Wishing for wishes)