What is a GitHub profile README?

A GitHub profile README is a special repository (named after your username) that displays on your GitHub profile page. It lets you showcase your skills, projects, stats, and social links to visitors.

How do I set up my profile README?

Create a new repository with the same name as your GitHub username. Add a README.md file — its content will appear on your profile. Use this generator to create the content, then paste it into your README.md.

What badges and stats can I include?

The generator supports technology skill badges, GitHub stats cards (commits, PRs, streak), social media links, and custom sections for your bio, current work, and projects.

Can I customize the generated README?

Yes. The generator creates markdown that you can freely edit. Add, remove, or rearrange any section. The output is standard markdown compatible with GitHub.

GitHub Profile README Generator

Create a professional GitHub profile README in seconds. Choose a template, add your skills, connect your stats, and copy the markdown. Everything runs in your browser.

Template

Basic Info

Name

Subtitle

GitHub Username

About

What are you up to?

Currently working on

Currently learning

Looking to collaborate on

Ask me about

Fun fact

Social Links

Website URL

Twitter username

LinkedIn username

Tech Stack

Generated Markdown

# Your Name

## 📊 GitHub Stats

![GitHub Stats](https://github-readme-stats.vercel.app/api?username=yourusername&show_icons=true&theme=tokyonight&hide_border=true)
![GitHub Streak](https://github-readme-streak-stats.herokuapp.com/?user=yourusername&theme=tokyonight&hide_border=true)
![Top Languages](https://github-readme-stats.vercel.app/api/top-langs/?username=yourusername&layout=compact&theme=tokyonight&hide_border=true)

---
*Generated with [DevToolkit](https://devtoolkit.cc/tools/github-readme-generator)*

Copy and paste into your GitHub profile repository's README.md

3 Templates

Choose from Minimal, Banner, or Centered layouts. Each template generates clean, well-structured markdown.

50+ Skill Badges

Pick from 50+ technology badges powered by shields.io. Languages, frameworks, databases, and DevOps tools.

GitHub Stats Widgets

Add GitHub stats, streak counters, top languages, trophies, and visitor badges automatically.

How to Use

1 Fill in your profile details — name, bio, what you're working on, and social links.
2 Select your tech stack badges from 50+ options across languages, frameworks, and tools.
3 Choose which GitHub stat widgets to include (stats card, streak, top languages, trophies).
4 Click "Copy Markdown" and paste it into your username/username repository's README.md file.