Profile README Generator

Profile README Generator

Build a GitHub profile README from your real GitHub stats. Type your username and see your profile built in one of the best-selling GitSkins templates.

Try: · ·

README.mdPro template

Comparing generators?

We wrote an honest comparison of the free and paid options, including ours: the best GitHub profile README generators, compared.

Guides

How to add a README to your GitHub profile

  1. Create a public repository named exactly like your GitHub username.
  2. Add a README.md file to it.
  3. Paste the Markdown from this generator, or publish from the full builder, and open your profile. The full walkthrough is in how to make a GitHub profile README.

Questions

What is a GitHub profile README?

It is a README.md in a public repository named after your username (for example octocat/octocat). GitHub shows it at the top of your profile page, above your pinned repositories.

Is this profile README generator free?

Previewing is free, with no account needed: type your username and see your README in a template. The free templates cost nothing to use. Premium templates need GitSkins Pro, and each one is marked.

Does it use my real GitHub stats?

Yes. Cards and templates are drawn from your public GitHub data: repositories, stars, languages and contributions. They update by themselves, so your README stays current.

How do I add the README to my profile?

Create a public repository with the same name as your GitHub username, add a README.md, and paste the Markdown. In the full builder you can also publish it to GitHub in one click.