markdown extracted so it can be reused anywhere else