I recently found out it’s surprisingly easy to add your own
man pages from Markdown notes.
Just add the path to the
MANPATH environment variable:
pandoc --standalone --to man --from markdown "my-note.md" --output "$HOME/.man/man9/my-note.9"
9 is the
man page section, I chose
9 for my own notes because there weren’t many existing
man pages in that section. This means I can tab complete from only my notes by typing for example
man 9 my-⇥.