How to add a README file to your GitHub profile markdown files are great for documenting projects, but did you know you can add a file directly to your GitHub profile? GitHub recently released a hidden feature that does just that!

This article will briefly cover how to set up and modify your GitHub profile file.


  1. After you have logged into GitHub, click the "New" button to create a new repository.

  2. Make the name of the newly created repository match your GitHub username.

  3. Make sure the the repository is set to public.

  4. Check the "Add a README file" checkbox.

  5. Edit the file directly on or by pulling the repository down to a local directory to edit. The changes will be instantly reflected on your GitHub profile.

You can add text, emojis, images, tables, and anything else you would normally add to a file, using GitHub's flavor of markdown.

For more information about profile files, checkout GitHub's own documentation at:

Is there an error, or incorrect information in this post? Let me know!