Improving markdown support in READMEs. fixes and closes #12