Describe what you need and the generator drafts profile README Markdown for GitHub.
How it works
- Describe it
Fill in skills and stack, links, projects. - Generate options
Get several profile READMEs written for GitHub. - Pick, edit and use
Choose one, make it yours and paste it into GitHub.
Where GitHub shows it
The profile README sits next to other profile fields; each has its own limit and place.
| Field | Limit | Where it shows |
|---|---|---|
| Username | - | in every repository URL |
| Profile README | - | top of your profile |
| Pinned repositories | 6 | on your profile |
| Bio | - | under your avatar |
How a GitHub profile README works
Create a public repository with exactly the same name as your username; its README.md shows at the top of your profile. Lead with what you build, pin your best projects and link where people can follow your work.
Angles the generator offers
Intro
Who you are and what you build.
Stack
Languages and tools.
Projects
Two or three highlights with links.
Contact
Where to follow or reach you.
Finish polishing before you publish
- GitHub Follow-back Checker
- GitHub Profile Analyzer
- GitHub Star History
- GitHub Stargazer Count Checker
- GitHub Stats Card Generator
- All free GitHub tools
- GitHub growth
Your profile README is ready. Now get the result.
Good copy earns the first look. Real stars and followers are what grow the profile.
Frequently asked questions
What does a profile README give?
It grows the account, but you need the right tool.
Where does a profile README appear?
At the top of your GitHub profile, from a repository named after your username.
Where is a GitHub username shown?
In your profile address and in every repository URL.
Is the GitHub profile README generator free?
Yes. It is free to use on this page, with no sign-up.
Where does the username show on GitHub?
In every repository URL.
Is it available now?
Yes. It works on this page today, free and with no sign-up.
How do I show a README on my GitHub profile?
Create a public repository with exactly your username as its name; its README.md shows on your profile.
How many repositories can I pin on GitHub?
Up to six.
