I started to use markdown to take notes.
I use marked to view my markdown notes and its beautiful.
But as my notes get longer I find it diff
For the benefit of those of us making README.md files in Atom (how I found this thread):
README.md
apm install markdown-toc
https://atom.io/packages/markdown-toc