Generatore di README del profilo GitHub

Risultati

Creare un repository il cui nome corrisponde al tuo nome utente GitHub ti dà un README che appare in cima alla tua pagina del profilo. Questo generatore produce un file Markdown pulito per quel repository: intestazione, breve biografia, stack tecnologico e schede statistiche opzionali alimentate da github-readme-stats.

Come costruire il README del profilo

  1. 1

    Compila i tuoi dettagli

    Nome visualizzato, tagline, posizione, cosa stai facendo e imparando.

  2. 2

    Aggiungi il tuo stack tecnologico

    Elenco separato da virgole; ogni elemento viene visualizzato come un chip in grassetto.

  3. 3

    Abilita le schede statistiche

    Le schede GitHub Stats e Top Languages vengono visualizzate in tempo reale da github-readme-stats; l'opzione attività aggiunge un link al tuo grafico dei contributi.

  4. 4

    Copia il Markdown

    Crea un repository chiamato come il tuo nome utente e carica il README.md nella radice.

Come funziona il “repository speciale”

Se il tuo nome utente è alex e crei un repository pubblico chiamato alex, GitHub visualizza il README.md di quel repository sul tuo profilo (sopra i repository popolari). È una funzione documentata, non un hack.

Schede che il generatore può incorporare

Scheda URL di origine Note
Statistiche GitHub github-readme-stats-one-bice.vercel.app/api?username=...&show_icons=true Commits, PR, problemi
Lingue principali github-readme-stats-one-bice.vercel.app/api/top-langs/?username=... Ripartizione delle lingue per dimensione del repository
Attività dei contributi github.com/{username}?tab=overview Link mostrato quando “Streak” è attivo

Le due schede statistiche sono endpoint PNG e vengono visualizzate su qualsiasi visualizzatore Markdown, anche quando qualcuno carica il tuo profilo senza autenticazione; il link attività apre il tuo grafico dei contributi su GitHub.

Contenuti che si leggono bene

  • Tagline in una riga: ruolo + focus (“Ingegnere infra Rust, interessato al tracing”).
  • Massimo 3–5 punti elenco sopra lo stack; di più e appare come un CV.
  • Competenze come chip, non un paragrafo. I lettori cercano tecnologia.
  • Link a progetti che mantieni effettivamente. I repository abbandonati fissati sul profilo sono peggiori di nessuno.
  • Linea di contatto: email o un singolo social handle; evita di elencare sei reti.

Cosa non mettere lì

  • Indirizzi privati o numeri di telefono.
  • Testo per reclutatori (“Aperto a opportunità” appartiene a LinkedIn o all’opzione banner di GitHub).
  • Emoji su ogni riga, una o due vanno bene, una giungla è rumore.

Domande frequenti

github-readme-stats è ospitato su Vercel e occasionalmente limita il tasso o memorizza dati obsoleti. Se una scheda non funziona, aspetta qualche minuto o ospita il progetto in modo autonomo, il repository ha un pulsante di distribuzione Vercel con un clic.

Solo se autentichi il servizio con un token che ha il campo repo. Per impostazione predefinita, le statistiche contano solo i commit pubblici, che è di solito la scelta giusta su un profilo pubblico.

Sì. GitHub consente un sottoinsieme di HTML in Markdown, <img>, <details>, <sub>, <sup> e stili inline semplici. Script e moduli vengono rimossi per motivi di sicurezza.

No. I valori che digiti vengono inviati al nostro server per generare l’anteprima e, nella vista a più passaggi, vengono trasportati nel link della pagina tra un passaggio e l’altro. Non viene salvato nulla in un database e tutto viene scartato quando chiudi la scheda.

Strumenti correlati

Strumento disponibile in altre lingue