convert spec document to markdown, some editing