some improvements + markdown api
typo