Well, I consider org-mode friendlier than markdown, but besides the language differences you are mostly missing the Emacs goodies. - you can weave this file to

Well, I consider org-mode friendlier than markdown, but besides the language differences you are mostly missing the Emacs goodies. - you can weave this file to one or several code files, even export the plain text parts as comment on the language if you decide so. - you can execute the code directly from your local machine into one, or different remote machines. - you can use the output from a previous block inside another block, even preprocess it on another language before executing in another block. - you can get the results recorded on the same file you're executing so you can also document what would the results be for executing x command. - if you use Emacs as another tool, you can easily send the results for example on email, slack, irc or whatever system you can interact with on Emacs. I think confluence made it harder on recent versions, but previously I was able to generate documentation pages and easily upload them to confluence without worrying about format or even upload.