O post Como criar um README excelente no GitHub demonstra como fazer um README.md excelente para seus projetos armazenados na plataforma GitHub. O post abordara sobre markdown, formatação, imagens, GIFs, links, listas, quotes, tasklists e muito mais.
Como criar um README excelente no GitHub
O que é o README
O README é uma linguagem marcação, assim como HTML e serve basicamente para estilizarmos texto na web. Sua extensão é .md justamente para indicar que o mesmo é um arquivo de marcação.
Sintexe e seus equivalentes em HTML
Header (equivalente aos <h1><h2><h3>)
![](https://miro.medium.com/max/1088/1*IJD9zo_HqSPKzf9w8vefPw.png)
Ênfase (equivalente ao negrito <b>, itálico <i> e riscado <strike>)
![](https://miro.medium.com/max/1400/1*uWNnCifnag5EX6FnsyI14A.png)
Lista Ordenada (equivalente ao <ol>)
![](https://miro.medium.com/max/1158/1*rVLdu9lVaVv5vBQdWROVbA.png)
Lista Não Ordenada (equivalente ao <ul>)
![](https://miro.medium.com/max/1154/1*ESSB9LxH0MLEndK9X0COrA.png)
Links (equivalente ao <a>)
![](https://miro.medium.com/max/1400/1*qXsQA9L84q8BhQG1jc5jqg.png)
Quotes (equivalente ao <blockquote>)
![](https://miro.medium.com/max/1400/1*OQ2bPG78Thi5iCbFZK1-nQ.png)
Tasklists
![](https://miro.medium.com/max/934/1*81XrVqH517e7d3OxxuIaBg.png)
Código
![](https://miro.medium.com/max/880/1*pXBK7_EDaUvIQVvtG1gtqg.png)
Tabelas
Em markdown temos que basicamente desenhar a tabela, porém existe um gerador de tabelas que facilita a nossa vida: gerador
Basta copiar o que o gerador criar e colar no README.md.
Em HTML usamos a nossa conhecida <table>:
![](https://miro.medium.com/max/1400/1*BRTb5_3uZR4IAR8TI55kcg.png)
Imagens e Gifs
Ensinarei duas maneiras, a maneira “espertinha” (e que eu não recomendo tanto) e a maneira mais “correta”. Faça como achar melhor.
Primeiro a maneira “espertinha”. Vamos em New Issue e jogamos a imagem lá, o GitHub hospeda e já converte em um link certinho, basta copiarmos e jogarmos no README.md, se liga só:
![](https://miro.medium.com/max/1400/1*Hh41cNKOLzJIK5Zo46dt-A.gif)
E agora uma maneira mais controlada. Tendo a imagem que queremos em um diretório do nosso repositório, basta usar a seguinte sintaxe:
Em markdown: ![](caminho até a imagem)
Em HTML: <img src=”caminho até a imagem”>
Com a tag HTML também podemos usar os atributos height e width para alterar o tamanho 😀
Ambas as maneiras funcionam com links externos, vamos a alguns exemplos de sintaxe:
![](https://miro.medium.com/max/1304/1*Mk3Zr033VC4gVErIylcfdA.png)
Para criar parágrafos basta dar um enter entre as linhas e para pular a linhar colocar dois espaços em branco no final da linha.
fonte: midium.com