DEV Community


QuickTip: GitHub profile readme

ivanovyordan profile image Yordan Ivanov Originally published at on ・2 min read

GitHub is important for your career. You know It’s like your public portfolio. The question is how to make it stand out? Luckily, GitHub released a pretty cool feature, and in this quick tip, we will see how to use it.

So, as we already said, GitHub recently released a new feature that can make your profile stand out, or at least look a bit more personalized. All you need to do is to create a profile-level READMEfile, and GitHub will display it on top of your page.


We all know how important READMEs are for documenting every project. It’s often the border between working alone and finding contributors. I think using README for documenting people is a great idea.

But why do we need README when we can just write a short bio? Well, Markdown is more flexible - we can place links, images, or even GIFs. README also takes more space in the centre of peoples screens. With all that freedom and space awesome people can make awesome things.


Enough talking, let’s see how to beautify our profiles. It’s fast, and you can do it in three easy steps:

  1. Go to and create a repository with the same name (including casing) as your GitHub username
  2. Create a file and add your fancy code there
  3. Commit (and push)

Creating a new repository Creating a new repository

What if you already have a repository with the same name? I’d recommend renaming the existing project, or if possible, changing the content of the README file.


My profile README is relatively simple. You can see how it looks like by checking my GitHub profile.

Of course, you may have better ideas like placing animated portraits, skill endorsements or even the tracks that you are listening in Spotify. You can find all this and even more in a GitHub repository.

I showed you mine, now it’s your turn to show me yours.

Discussion (0)

Forem Open with the Forem app