using formatted output

formatted output should be a true Markdown file/format