If you are here that means you want to create a stunning README.md for your Awesome Repos, So down below I'm going to show you some cool markdown tips (.md means markdown) Markdown is a lightweight markup language for creating formatted text using a plain-text editor.
Good Documentation is as much important as your project, because if you can't explain what your project does, how other can utilize it, then there is no mean of developing awesome projects.
- A README.md file is a guide that gives visitors a detailed description of your project. There is a lot of developers that developed awesome application but if you represent your project well than your project will have great impact, it will gain more.
- If someone visits your project repo then this is the file that will represent your project. So you should put some effort to make your README.md look good.
- You don't need to make always a new README.md. Just create a template and use that for all the projects.
When you write a README.md file always keep in mind that this is for others not for you.
Now have a look at my project and share your thoughts with me, what you think about the repo it is looking good or not? Can you use this project without any help just by reading README.md?
You can also create simple and stunning README.md in very simple steps.
One more thing you need to know there is no right or wrong way of Creating README.md, Every Developer has their way of writing the README.md file. I'll explain to you each and everything you can do to create your own.
Github uses its markdown known as GFM (Github Flavour markdown). It just extends the functionality of markdown. So, you can use simple HTML tags and their attributes to make it look good. You can use Emojis, links, pictures,
At the very top, you must include a project title using heading 1, Now heading 1 in markdown is with one # sign but you can also use the h1 tag. For example:
# Project title
or I also like to make it center so,
<h1 align="center">Project title</h1>
we are using, align="center" because we can't use CSS here.
After the title, you must provide a description of the project and it should not be a long paragraph just a simple descriptive line will do the job. This is the line that should be well crafted and straightforward.
It describes the quality of your project because no one will run the project at the moment they visit but they judge the project its description.
# Project Description
or if also like to make it at the center so,
<p align="center">Project Description</p>
Github added this feature already so you don't need to do it. So, Just use headings (#), subheadings(#), or h1,h2 tags and it will automatically have at the top left corner of your README.md file.
Use markdown link as
[Link Text](link) of your live project, repo, API, API repo. I am sure you are wondering why you should put repo here but your project is not always be seen on GitHub people also clone it on their system and this file also gets cloned so you must put this link there. So, anyone can visit back the repo.
You can use Images to show your project, how it looks while running. For putting screenshots you can either drag and drop images or use the image in markdown as
![Image Name](Image location)
The most important part after the description is this, You need to provide instruction on how to install your program and how to run it. Make it comprehensive as much as possible So, even a beginner can use it.
In this section, you can add your tech stack, as which technologies you used to make the project. You can utilize list as
Here you can use a Special GFM Feature called a task list. A task list will show which things are done and which are pending. You can utilize a task list as
- [ ] Reliable Storage // This is pending - [x] Authentication // This is done
Here you can show your details like email, profile, website, any other social media links so others can follow you.
This can be some simple markdown links as
**Rohit Jain** - [Profile](https://github.com/rohit19060 "Rohit jain") - [Email](mailto:email@example.com?subject=Hi% "Hi!") - [Website](https://kingtechnologies.in "Welcome")
If someone puts effort to do something into your project then you should give him/her credit for it and this is the section for that here you can use images and links of your project contributors.
At last, you can ask for support or sponsorships by providing links or just add a simple message as
Contributions, issues, and feature requests are welcome! Give a ⭐️ if you like this project!
As I mentioned above you can use the following template as your template after making necessary changes.
- **Bold** - _italics_ - ~~Strike through~~
Their combination also works like
> This is a Blockquote
- Candy - Gum - Booze 1. Red 2. Green 3. Blue - [x] Finish my changes - [ ] Push my commits to GitHub - [ ] Open a pull request
if you put a link inside arrows like
<firstname.lastname@example.org> Github automatically make it a link.
| Left-aligned | Center-aligned | Right-aligned | | :----------- | :------------: | ------------: | | git status | git status | git status | | git diff | git diff | git diff |
You can use variables in markdown or references as
This is all you can do in the README.md file to make it stunning and stand out from others. Comment down below your favorite part or your README styles