improved markdown for map documentation