add doc/ and some documentation of markdown inconsistencies.