fix every spec explanation to markdown format