Guides
Make your GitHub profile stand out
Short, practical guides to profile READMEs, badges, stats and GitHub Markdown.
- How to Create a GitHub Profile README (Step by Step)Create the special repository, write your first README, and get it showing at the top of your GitHub profile, with fixes for the most common problems.6 min read
- GitHub README Badges: The Complete Shields.io GuideBuild tech-stack, social and repo badges with shields.io: URL format, styles, logos, colours, escaping rules and how to space badges on GitHub.7 min read
- How to Add GitHub Stats to Your Profile READMEAdd stats cards, top languages, streaks, trophies, a contribution graph and a view counter, plus how to fix cards that don't load or don't update.7 min read
- 15 GitHub Profile README Ideas to Stand OutPractical ideas for your GitHub profile README, from a sharp intro and featured projects to auto-updating blog posts and a contribution snake.6 min read
- GitHub Markdown Cheat Sheet for READMEsEverything you need to format a README on GitHub: centring, image sizes, dark-mode images, collapsible sections, alerts, tables and what HTML GitHub allows.8 min read