doc: Update markdown flavored syntax (using linguist)