Fixing & improving markdown

* На няколко места беше счупен markdown-a и го оправих
* На няколко места добавих Java като syntax на кода :)

Мисля да оправя още  няколко неща по MD-то и ще commit-на още 1 път