Communicating using Markdown

Your guide to mastering Markdown


Join this course

GitHub Learning Lab is an integrated learning experience to help you learn how to use GitHub by using GitHub. Complete courses at your own pace on collaboration, workflow, and more.

GitHub is about more than code. It’s a platform for software collaboration—and Markdown is one of the most important ways developers can make their communication clear and organized in issues and pull requests.

This course will walk you through creating and using headings more effectively, organizing thoughts in bulleted lists, and showing how much work you’ve completed with checklists. You can even use Markdown to add some depth to your work with the help of emoji, images, and links. See a word you don't understand? We've included an emoji 📖 next to some key terms. Click on it to see its definition.

In this course, you’ll learn how to:

  • Use Markdown to add lists, images, and links in a comment or text file
  • Determine where and how to use Markdown in a GitHub repository

This course has a dedicated message board on the GitHub Community website. If you want to discuss this course with GitHub Trainers or other participants create a post over there. The message board can also be used to troubleshoot any issue you encounter while taking this course.

Ready to start learning?