use markdown where appropriate