details : markdown cleanup

just turned that document into real markdown without HTML hacks. well, almost.