These are some great reasons .org is a good replacement for .md. I should look into toc-org
---
RT @heymingwei
The experience of writing README in @emacs Org-mode is unreal!
Some of the benefits:
1. folding and focusing on sections
2. auto-generate table of content (toc-org)
3. call API and format results directly in doc
4. inline display images
5. magical git interface (magit)
https://twitter.com/heymingwei/status/1457085662541193218