Creating amazing GitHub profiles README
Tags: github, markdown, profile, branding
Published: 2020-07-15 14:54:35

In the past few days, Github implemented a way to personalize our profile pages: Profile README. And it's amazing since we can now add a full description of ourselves and also mention which projects and studies we are focusing on, for example.

In this article, I'll highlight some creative examples and show you how you can create your own Profile README. 😎

---

## About READMEs

README files typically include information about the project and each repository should have one. What the project does, how users can use the project and how to contribute to the project are some good content from READMEs. 

But this new GitHub feature called Profile README can be used to inform people of more information about ourselves. It also supports markdown, which means that we can play a lot with HTML, gif, emoji... [Read this GitHub article and Master Markdown](https://guides.github.com/features/mastering-markdown/).

Feel free to check out [my GitHub profile](https://github.com/dionarodrigues). And below you can see a list of awesome repositories of examples of READMEs:
- [kautukkundan/Awesome-Profile-README-templates](https://github.com/kautukkundan/Awesome-Profile-README-templates)
- [abhisheknaiidu/awesome-github-profile-readme](https://github.com/abhisheknaiidu/awesome-github-profile-readme)

---

## How to create your own Github  Profile README

You can do this through the following steps:

1- [**Create a new repository**](https://github.com/new) with the same name as your GitHub account (in my case that´s [github.com/dionarodrigues/dionarodrigues](https://github.com/dionarodrigues/dionarodrigues)).

![GitHub New Repository Page](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/hb6v3i0bx2u62zwdxj1x.jpg)

This repository needs to be public and initialized with a README.

2- **Edit README.md file** with a customized content about you. 

![GitHub README editing page](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/m73r8wzq3kfc3ymw72tf.jpg)

3- **Go to you profile page** to see the changes. 

![Diona Rodrigues Github Profile Page](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/gm1g5hyuea0fk5nhqw9q.jpg)

You can now see a new section at the top of the page that was automatically rendered from the new Profile README file.

---

## How to improve your GitHub Profile READMEs content

![Alt Text](https://dev-to-uploads.s3.amazonaws.com/i/z09wemeeut7m5ob4i6al.jpg)

You can also learn how to [build a self-updating profile](https://simonwillison.net/2020/Jul/10/self-updating-profile-readme/) ✨.

Learn how to [add shields](https://shields.io/) into the content.

Learn how to add [GitHub Readme Stats](https://github.com/anuraghazra/github-readme-stats#github-stats-card) on your readmes!

See [how to add Emoticon](https://gist.github.com/rxaviers/7360908).

---

## Creative examples of GitHub Profile READMEs

[github.com/Thaiane](https://github.com/Thaiane)
![GitHub Profile Screenshot of Thaiane](https://dev-to-uploads.s3.amazonaws.com/i/4s3eo30pe6uezkujqyg0.jpg)

[github.com/ashbakernz](https://github.com/ashbakernz)
![GitHub Profile Screenshot of Ash Baker](https://dev-to-uploads.s3.amazonaws.com/i/b5klltjsacjnrqlynemm.jpg)

[github.com/jlengstorf](https://github.com/jlengstorf)
![GitHub Profile Screenshot of Jason Lengstorf](https://dev-to-uploads.s3.amazonaws.com/i/5jsdch10bou5tldd5ntn.jpg)

[github.com/saadeghi](https://github.com/saadeghi)
![GitHub Profile Screenshot of Pouya Saadeghi](https://dev-to-uploads.s3.amazonaws.com/i/2xed7qpbjnr8odd61znl.jpg)

[github.com/VedantKhairnar](https://github.com/VedantKhairnar)
![GitHub Profile Screenshot of Vedant Khairnar](https://dev-to-uploads.s3.amazonaws.com/i/vlhi73q3tbeqvxje2qp8.jpg)

[github.com/stephenajulu](https://github.com/stephenajulu)
![GitHub Profile Screenshot of Stephen Ajulu](https://dev-to-uploads.s3.amazonaws.com/i/idukvslq5fp0efakuvps.jpg)

[github.com/abhisheknaiidu](https://github.com/abhisheknaiidu)
![GitHub Profile Screenshot of Abhishek Naidu](https://dev-to-uploads.s3.amazonaws.com/i/u2r3erv2qqh011ha8afx.jpg)

---

**I'm very excited about this GitHub release. How about you? Have you already changed your profile page?**