Markdown is becoming the lingua franca for producing online documentation. In this session, I provide a brief introduction to Markdown, its importance, and basic markup. I show how we use Visual Studio Code (VS Code) and the various extensions to write documentation at Microsoft. I will talk about best practices, including the importance of style guides, proper formatting of Markdown for readability and maintainability, and why we chose the rules we use.

If you are getting started with a documentation project or want to improve your documentation process, this is the session for you.