Gerador de README de Perfil do GitHub

Resultados

Criar um repositório cujo nome corresponda ao seu nome de usuário do GitHub fornece um README que aparece no topo da sua página de perfil. Este gerador produz um arquivo Markdown limpo para esse repositório: título, biografia curta, stack de tecnologia e cartões de estatísticas opcionais gerados pelo github-readme-stats.

Como construir o README do perfil

  1. 1

    Preencha seus dados

    Nome de exibição, tagline, localização, no que você está trabalhando e aprendendo.

  2. 2

    Adicione sua stack de tecnologia

    Lista separada por vírgulas; cada item é renderizado como um chip em negrito.

  3. 3

    Ative os cartões de estatísticas

    Os cartões de Estatísticas do GitHub e Top Languages são renderizados ao vivo a partir do github-readme-stats; a opção de atividade adiciona um link para o seu gráfico de contribuições.

  4. 4

    Copie o Markdown

    Crie um repositório nomeado após seu nome de usuário e envie o README.md na raiz.

Como o “repositório especial” funciona

Se seu nome de usuário é alex e você cria um repositório público chamado alex, o GitHub renderiza o README.md desse repositório no seu perfil (acima dos repositórios populares). É um recurso documentado, não uma gambiarra.

Cartões que o gerador pode incorporar

Cartão URL de origem Notas
Estatísticas do GitHub github-readme-stats-one-bice.vercel.app/api?username=...&show_icons=true Commits, PRs, issues
Linguagens principais github-readme-stats-one-bice.vercel.app/api/top-langs/?username=... Divisão de linguagens por tamanho do repositório
Atividade de contribuição github.com/{username}?tab=overview Link exibido quando “Streak” está ativado

Os dois cartões de estatísticas são endpoints PNG e renderizam em qualquer visualizador Markdown, incluindo quando alguém carrega seu perfil sem autenticação; o link de atividade abre seu gráfico de contribuições no GitHub.

Conteúdo que é bem lido

  • Tagline de uma linha: função + foco (“Engenheiro de infra Rust, interessado em rastreamento”).
  • 3–5 pontos no máximo acima da stack; mais do que isso parece um despejo de CV.
  • Habilidades como chips, não um parágrafo. Leitores escaneiam por tecnologia.
  • Links para projetos que você realmente mantém. Repositórios abandonados fixados no perfil são piores do que nenhum.
  • Linha de contato: e-mail ou um único perfil social; evite listar seis redes.

O que não colocar lá

  • Endereços ou números de telefone privados.
  • Cópia para recrutadores (“Aberto a trabalho” pertence ao LinkedIn ou à opção de banner do GitHub).
  • Emojis em cada linha, um ou dois estão bem, uma selva é ruído.

Perguntas frequentes

github-readme-stats está hospedado no Vercel e ocasionalmente limita a taxa ou armazena em cache dados desatualizados. Se um cartão quebrar, aguarde alguns minutos ou auto-hospede o projeto, o repositório tem um botão de implantação Vercel com um clique.

Apenas se você autenticar o serviço com um token que tenha escopo repo. Por padrão, as estatísticas contam apenas commits públicos, o que geralmente é a escolha certa em um perfil público.

Sim. O GitHub permite um subconjunto de HTML no Markdown, <img>, <details>, <sub>, <sup> e estilos inline simples. Scripts e formulários são removidos por motivos de segurança.

Não. Os valores que você digita são enviados ao nosso servidor para gerar a prévia e, na visão em várias etapas, são transportados no link da página entre as etapas. Nada é armazenado em um banco de dados e tudo é descartado quando você fecha a aba.

Ferramentas relacionadas

Ferramenta disponível em outros idiomas