fully converted to markdown / made more vim friendly