On September 1, 2022, GitHub Learning Lab will shut down.
Read more on the GitHub blog and check out GitHub Skills for courses backed by GitHub Actions.
See an up-to-date option for this page.

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 free course Join 47528 others!

social preview

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.

What you'll learn

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

What you'll build

screen shot of published GitHub pages site

  • A published GitHub Pages site showcasing different types of Markdown that you can edit and use in the future


In this course you will work with issues and pull requests, as well as edit files. If these things aren't familiar to you, we recommend you take the Introduction to GitHub course, first!

Projects used

This makes use of the following open source projects. Consider exploring these repos and maybe even making contributions!

  • Jekyll: a simple, blog-aware, static site generator.


Developers, GitHub users, users new to Git, students, managers, teams

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

45 minutes


All public courses on Learning Lab are free.

Latest release

Learning Paths that include this course

Users who took this course also took

What is GitHub Learning Lab?

Learn new skills by completing fun, realistic projects in your very own GitHub repository.

Ready to start learning?

Start Communicating using Markdown