There seems to be quite a bit of cargo-cult/copy-paste of the mdoc(7) markup when it comes to writing manual pages. Some time ago I tried to write a tutorial but kinda hit a writer's block. Then I tried to just do a jumbo^Hled man page(s) to have a single convenient source for casual users to steal from, but, again, got sidetracked with other things.
I thought to commit these somewhere to /usr/share (examples, probably), but at the current rate I'm not sure when I'll get around to it. Since unfinished/imperfect is still better than nothing, I put the sources here: https://hg.sr.ht/~nbuwe/mdoc-tutorial/browse feedback and ideas on what to cover are welcome. -uwe