Replace rst markup for some wiki templates

also add section for rst markup to use in our readme.