Creating a Profile README on Github

Farhan Halai
2 min readJan 10, 2021

GitHub has an awesome feature of showing your information in a presentable format on your profile page.

YOU can use this as a selling point for you & showcasing your skills.

Check out this screenshot of my GitHub profile page.

My GitHub Profileā€™s Snapshot

The content seen in the green highlighted mark is shown from the profile README.

In this article, weā€™ll go through the steps for creating a Profile README:

  1. Create a new repository named as your GitHub username.
    For example, my GitHub username is ā€œfarhanhalai30ā€ so I have created a repository named ā€œfarhanhalai30ā€.
  2. Keep this repository as ā€œPublicā€.
  3. Check ā€œInitialize this repository with a READMEā€.
  4. Click on ā€œCreate repositoryā€.
  5. Now start editing the ā€œREADME.mdā€ file in this repository.
    GitHub already provides a basic template which you can follow OR create your own customized template.
    Few things you should consider are:
    a) A short introduction about YOU.
    b) List your skills.
    c) Provide your social handles to connect.
  6. Once you are done with editing the README.md file, save it.

Now, you should be able to view this information on your profile page.

Awesome, isnā€™t it !!! šŸ˜

For help related to Markdown syntax, you can refer

You just saw, how easily you can create your profile README with a few steps.

I would love to see what creativity you can bring out šŸ˜, do share your GitHub profile in the comments once you create your profile README.

Thanks for reading šŸ˜ƒ

You can connect with me on,
1. GitHub
2. Twitter
3. LinkedIn
4. DEV Community

--

--