Mastering Markdown for Github

There are ways to make your documentation more readable by the help of markdown

https://guides.github.com/features/mastering-markdown/
https://help.github.com/articles/basic-writing-and-formatting-syntax/#using-emoji