Check out my GitHub Profile README

Do You Want To README?

Now you can with GitHub Profile READMEs.

You found a secret

GitHub has released a sly little update that I’ve only just found out about. Welcome to Profile READMEs! These readmes are a great way to introduce yourself when someone visits your profile. Give the viewer a little insight into you as a person/programmer/designer/whatever-you-are and start off on the right foot.

The readme is whatever you want it to be! This little file is all about you and that’s who you should make it for. When you show off your personality in the profile, that’s showing your true colors. That’s what people want to see. Customize and personalize. That’s the name of the game with GitHub Profile READMEs.

Let’s get into it.

Create a new Repo

That’s right. You’re going to need a new repo. A special repo. A repo unlike any repo ever repo’ed before-oed.

Start at and create a repo with the same name as your username — so really, not super unique since you made it before 😉.

Be sure to select the “Add” file before creating the repo of course.

^ Right at the bottom over here.

Once you’ve created that, the rest is really up to you! You don’t even need to pull a local copy of the repo, you can add files in GitHub. There are actually a lot of glowing green buttons to press once you’re inside the repo itself.

Here’s mine for an example:

I like Owls 🦉


My own readme is based on a few:

I think it’s important to get different ideas and insights from others to make things your own. Creating something completely and utterly unique in today’s world is difficult. Why not iterate on something too make it your own. Take ideas and mash them together, something that may be done before, but not with a different spin. It’s not that it’s totally unique, but it is something you made.

Thank you for taking the time to read! I found this out the other day and just had to share. Sorry this is a bit shorter, but files are quite common now-a-days. If you haven’t seen one before, GitHub has a great tutorial on it; something that will help you master the art of Markdown.

Please link your Profile README’s below! I would love to see what you’ve created.

All the best and stay safe — Spencer

💻Software Engineer | Game Developer | DevOps | Project Enthusiest | Technical Writer — Working to make things simpler. I’ll tell you my story as it unfolds 📖

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store