doc changes - markdown conversion issues