DEV Community

Cover image for Beautify Your GitHub Profile README
Xyphuz
Xyphuz

Posted on

6 2

Beautify Your GitHub Profile README

Have you ever seen a beautiful profile README while browsing the GitHub profiles of someone?

You may be wondering how to make it look like that. Here are some tips:

Use HTML Elements

Because README uses Markdown syntax, there are some features in the layout that HTML Elements can do that Markdown cannot, such as centering blocks and resizing images.

Use Tools

There are many tools that can help you make your README more beautiful. The idea is to use the GitHub API to dynamically generate SVG charts that show your GitHub data, such as contribution amount, cost used languages or total star earned, total PRs... etc.

For Badges

For badges, try shields.io, it helps you create many different kinds of badges, and there are many parameters to create the badge you want to show.

repo-link

Here is an example:

badge-example

For Stats

For stats, try github-readme-stats, it helps you create SVG for all kinds of your GitHub stats.

repo-link

Here is an example:

stats-example

For Commit/Contribution Graph

For commit/contribution graph, try github-contribution-graph!

It's an awesome tool for dynamically generating contribution graphs that show your GitHub contributions.

It's beautiful, it has SLIM animation, and it supports custom background image (even .gif !)

repo-link

Here is the demo:

Image description

Okay, that's all about today's tips!

If you have any ideas or questions, please feel free to share them with me in the comment section!

If you like any of the above tools, don't forget to leave a star in their GitHub repo!

Billboard image

The Next Generation Developer Platform

Coherence is the first Platform-as-a-Service you can control. Unlike "black-box" platforms that are opinionated about the infra you can deploy, Coherence is powered by CNC, the open-source IaC framework, which offers limitless customization.

Learn more

Top comments (0)

The Most Contextual AI Development Assistant

Pieces.app image

Our centralized storage agent works on-device, unifying various developer tools to proactively capture and enrich useful materials, streamline collaboration, and solve complex problems through a contextual understanding of your unique workflow.

👥 Ideal for solo developers, teams, and cross-company projects

Learn more