Create a ReadMe File in Git

Git Tips & Commands

A ReadMe file is a standard place for instructions or documentation that you want to share with people about a repo. Here's how to add a ReadMe file to your Git repo.

Full-Stack Web Development Certificate: Live & Hands-on, In NYC or Online, 0% Financing, 1-on-1 Mentoring, Free Retake, Job Prep. Named a Top Bootcamp by Forbes, Fortune, & Time Out. Noble Desktop. Learn More.

Create a ReadMe File

1. Create a file named README.md in the root (based) folder of the Git repo.
2. Add any instructions or documentation that you want to share with others. Use Markdown to format headings, lists, links, etc. Here are some guides for the Markdown syntax:

  • daringfireball.net/projects/markdown/syntax
  • guides.github.com/features/mastering-markdown

3. When done, commit the changes and push them to the remote repo. GitHub and Bitbucket will display the nicely formatting ReadMe on the project page for the repo.

What is Markdown?

Markdown can be converted into other formats (such as HTML) and has been incorporated into many things. It's the standard format for ReadMe files in Git.

John Gruber of Daring Fireball (daringfireball.net) created Markdown. He says "Markdown is intended to be as easy-to-read and easy-to-write as is feasible. Markdown’s syntax is intended for one purpose: to be used as a format for writing for the web."

Go Beyond Git

Git is an essential tool for collaborating with other programmers. Learn Git and more through our coding classes & bootcamps:

How to Learn Git

Master Git with hands-on training. Git is a free, open-source version control system that allows developers to track the changes they make to code.

Yelp Facebook LinkedIn YouTube Twitter Instagram