Communicating using Markdown

This course will walk you through everything you need to start organizing ideas and collaborating using Markdown, a lightweight language for text formatting.

Start Communicating using Markdown Join 12311 others!

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.

Share Communicating using Markdown
Average time to complete

50 minutes


All public courses on Learning Lab are free.

Latest release

Learning Paths that include this course

Users who took this course also took

Ready to start learning?