improve markdown formatting ; added use of shapeindex.