Markdown is a way to apply unobtrusive formatting to text files to give it a bit of structure that can also be parsed so it can be presented in a GUI even more prettily than the text version.
Please remember that markdown is a text format first - you should make it readable as text. The readable GUI version comes automatically due to the nice GUI formatting, but it is easy to forget this and write markdown for GUI presentation only. Pay attention to how your text looks.