Creating your personal GitHub readme.md
Tags: github, git, webdev, beginners
Published: 2022-05-01 19:19:02

![roman-synkevych-UT8LMo-wlyk-unsplash.jpg](https://cdn.hashnode.com/res/hashnode/image/upload/v1623346250674/0iJW474c5.jpeg)<p align="center">Photo by <a href="https://unsplash.com/@synkevych?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText">Roman Synkevych</a> on <a href="https://unsplash.com/s/photos/github?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText">Unsplash</a></p>

  

Have you ever been to someone's GitHub profile and wondered how they had that nice portfolio looking section, and didn't know to create one, it's a cool thing you can do on GitHub to showcase your main repositories so when visitors or hiring managers drop by, they don't have to dig too deep to find it, drop your social media account links in an iconic way or view stats of your whole GitHub repositories and much more other cool features?

## Getting started
The first step in doing that is to create a new repository with your exact username, initialize a readme.md file and you're ready for business. 

## What's next?
The next thing is to get a bit familiar with the markdown syntax as that would be what you would use to create that space. You can check out Github's markdown cheatsheet here to get started: [https://guides.github.com/pdfs/markdown-cheatsheet-online.pdf]('https://guides.github.com/pdfs/markdown-cheatsheet-online.pdf') or [https://daringfireball.net/projects/markdown/]('https://daringfireball.net/projects/markdown/') to get started with markdown.

## Okay, what next?
Personally, I would create a draft of the content that I would add there and if there's any extra pizzaz like a banner that I want to add, then I design it. I used [canva.com]('https://www.canva.com/') to design the banner in the image above(sorry but Github doesn't have that feature yet or ever?). 

## Let's dive in

Image code:

`![Uzochukwu Precious (1)](https://user-images.githubusercontent.com/40992425/116480999-49a5a100-a87a-11eb-9a13-779b284fa634.png)`. 

### Socials icons
The icons I used for the socials is from [img.shields.io]('https://img.shields.io/'). 

`<p align="center">
<a href="https://twitter.com/justvibes401"><img src="https://img.shields.io/badge/twitter-%231DA1F2.svg?&style=for-the-badge&logo=twitter&logoColor=white" height=25></a> 
<a href="https://medium.com/@p-uzor99"><img src="https://img.shields.io/badge/medium-%2312100E.svg?&style=for-the-badge&logo=medium&logoColor=white" height=25></a> 
</p>`. 

This part is just HTML as you can also use HTML for some parts in a readme file.

#### Profile views
`![Profile views](https://gpvc.arturio.dev/uzor13)`,  change uzor13 to your Github username.

#### Repo card 
`[![Readme Card](https://github-readme-stats.vercel.app/api/pin/?username=uzor13&repo=github-jobs&show_owner=true&theme=blueberry)](https://github.com/uzor13/github-readme-stats)`,  change the username and repo to yours and you can also find out more theme names [here]('https://github.com/anuraghazra/github-readme-stats/blob/master/themes/README.md') and tweak your heart desire.

#### Stats card 
![Screenshot (50).png](https://cdn.hashnode.com/res/hashnode/image/upload/v1623345254068/dJsebNDIOd.png)


## Conclusion
There are still many features that can be added,  the aim is to make it personal and fill it up with things you like.


![Screenshot (30).png](https://cdn.hashnode.com/res/hashnode/image/upload/v1623353409959/ycwNgIfPZ.png) A screenshot of mine

This is my first article so thanks for reading to the end.