doc: finally decided to write the manual in markdown

will use same or similar doc helpers