Adding a README to your GitHub profile

rafacdomin profile image Rafael Domingues ・1 min read

Hello everyone, recently GitHub released a new feature that allows you to personalize your profile on the website in a very simple way, adding a README. You can see how mine looked below:

Alt Text

How to?

As I said before, it's quite simple, all you need to do is create a new repository with the same name as your username and add a README.md file to it

Now you only need to add some content (text, images, GIFs, emojis, etc.) to this README.md using the markdown syntax and commit the changes to the repo's main branch. Congratulations! This should be visible on your profile now :)
If you are not familiar with markdown syntax, check this guide: https://guides.github.com/pdfs/markdown-cheatsheet-online.pdf


Here are some examples of nice profiles that inspired me:

martins-rafael profile

M0nica profile

WaylonWalker profile

If you need more inspiration check this repository for more README profile examples.

I'm curious to see what your GitHub profile looks like, share the link to your profile below!

Posted on by:

rafacdomin profile

Rafael Domingues


# Full-Stack Developer πŸ‘¨β€πŸ’» # Engineering Student βš™οΈ Passionate about using technology to change people's lives πŸ’œ


Editor guide

Here is a tool that could help you to get started with github readme :)
Add description / social media / badges and other stuff with just few clicks..

GitHub logo arturssmirnovs / github-profile-readme-generator

⭐⭐⭐ Github profile readme generator allows you to create nice and simple github profile readme files that will be included in your profile previews.

Github readme generator

Hi there πŸ‘‹.

⭐⭐⭐ Check out this tool here.

Github readme generator

This project allows you to create nice and simple github profile readme files that will be included in your profile previews.

You can include multiple things: Headers, subtitles, skills, banner, additional information, social media links and statistics badges.



  • Go to: arturssmirnovs.github.io/github-pr...
  • Fill inputs
  • Copy code from textarea
  • Create repository with name that equals your github username
  • Add readme.md
  • Paste copied code and save
  • Enjoy


Github readme generator





Vue JS :)


This tool is amazing! Makes it a lot easier, thanks for sharing :)


Thanks for sharing, I didn't know this special repository!
Here's mine: github.com/gentax


Thanks for sharing knowledge!