Documentation

This is a great package and works well with just this in user-init-file

  (apheleia-global-mode)

But when I tried to use a less popular mode -- markdown-mode it took me hours to figure out how to configure it as elegantly as the packaga allows. (I spent lots of time trying ChatGPT-generated elisp that worked, but was convolutionarily complexicated). After I got it working and minimal, I want to share what I learned so that others can use this package to it's best effect instead of being stopped.

Even though the documentation was correct (in hind sight), it wasn't as helpful (in fore sight) as I would have hoped. It would be better to have an working example (or 3) than a definition of all the pieces.

Formatting

Ironically, I was trying to enable markdown-mode, so that once I had enabled auto-format for my own *.md files, emacs exposed that README.md was not compliant with the package's own prettier-markdown formatter.