converted specs to markdown