If there's a 1970's technology in bad need of an update, it's the man page format IMHO. Markdown is far easier to quickly learn and write.

But you completely missed my point of computational notebooks + shell and I'll just respond in kind with a link that you should research yourself: https://en.wikipedia.org/wiki/Project_Jupyter