updated documentation and added more markdown compatibility