/

Communicating using Markdown

Your guide to mastering Markdown

GitHub
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.

Steps to complete this course 10
  1. Create a task list

    Learn about task lists in your first issue.

  2. Turn on GitHub Pages

    Create serve your repository contents on a web page using GitHub Pages.

  3. Add headers

    Add headers to some unformatted content.

  4. Merge your headers

    Merge your first PR to see headers in action.

  5. Add an image

    Learn how to place images in Markdown by adding your photo.

  6. Add a profile link

    Learn how to create links in Markdown.

  7. Merge your image and link

    Merge your second PR to introduce yourself to the world.

  8. Add a list

    Learn to how to create ordered and unordered lists.

  9. Use emphasis

    Use bold and italics to emphasize text.

  10. Merge lists and emphasis

    Merge the last updates to your portfolio.

This course is part of some Learning Paths:

Getting help

Looking for help? Check out the GitHub Community Forum.

Ready to start learning?