DEV Community

Cover image for How to add GitHub Profile README (new feature)
Tuomo Kankaanpää
Tuomo Kankaanpää

Posted on • Originally published at

How to add GitHub Profile README (new feature)

This post was originally published at on July 17, 2020.

GitHub released a new feature few days ago: GitHub profile readme! You can now add a readme file to be displayed on your GitHub profile page.

See also If you use Git and VS Code – Read This!

This is a great way to tell more about yourself or for example advertise your blog or YouTube channel. The readme file supports markdown so you can do same things that you can with normal readme files in GitHub.

I uploaded a video to my YouTube channel where I show you how to add a readme file to your own GitHub profile. On the video I also go through couple of very cool and creative ways to use the readme file to boost your GitHub profile. You can watch the video below or clicking here.

If you rather read, here is a short summary on how to add the readme file to your profile (I still strongly recommend checking out the video and I would very much appreciate if you also subscribed to my YouTube channel, so you stay up to date on more videos I upload).

The way it works is you need to create a new repository and name it the same as your GitHub username is. So for example my GitHub username is tumetus, so I need to create a repository with name tumetus.

GitHub profile readme is hinted when creating the repository.

When you create the repository, you see a notification that you are creating a special repository and that the file of that repository will be shown in your profile.

The repository, as you might guess, has to also have a file (which is the file that will be shown in your profile page). You can initialise this when you are creating your repository.

You can initialise the GitHub profile readme file when creating the repo.

Once you have your repository created, go check you profile page and you can see that the readme file is displayed on top of your pinned repositories.

What does your GitHub profile readme file look like? Comment your GitHub profile below!

Top comments (1)

lorddashme profile image
Dash Reyes • Edited

Great Article!

Just want to share this to add some details for the Github README profile 😄