adds markdown and corrects grid syntax in docs