Portfolio di scrittura su GitHub o Notion: guida pratica

Un portfolio di scrittura è la prova concreta del tuo modo di lavorare. Racconta quali testi sai creare, per quali settori hai esperienza e come trasformi un brief in un contenuto utile, leggibile e orientato agli obiettivi. Per un web writer freelance può fare la differenza tra una candidatura generica e una proposta credibile.

GitHub e Notion permettono di costruire una raccolta professionale senza acquistare un dominio o sviluppare un sito da zero. Sono strumenti diversi: il primo nasce per gestire progetti e versioni dei file, il secondo per organizzare informazioni in pagine e database. Entrambi possono ospitare articoli, schede progetto, casi studio e indicazioni per contattarti.

La scelta dipende dal tipo di immagine che vuoi trasmettere. GitHub comunica ordine, metodo e familiarità con gli strumenti digitali; Notion offre una presentazione più visuale e semplice da aggiornare. In entrambi i casi, il valore del portfolio dipende dalla selezione dei contenuti e dalla chiarezza con cui presenti il tuo contributo.

Definire obiettivo e pubblico del portfolio

Prima di creare pagine e cartelle, stabilisci chi deve consultare il portfolio. Un’agenzia SEO cercherà probabilmente articoli ottimizzati, capacità di ricerca delle keyword e rispetto di una struttura editoriale. Un’azienda SaaS potrebbe preferire guide tecniche, landing page e contenuti capaci di spiegare prodotti complessi. Un editore valuterà invece tono, ritmo e precisione linguistica.

Il portfolio non deve contenere tutto ciò che hai scritto. Deve mostrare il lavoro più utile per ottenere il tipo di incarico che desideri. Se vuoi lavorare come content writer nel settore fintech, inserisci analisi, guide pratiche e testi che dimostrino familiarità con termini finanziari, sicurezza digitale o criptovalute. Se punti al blogging SEO, dai priorità ad articoli informativi con titoli, sottotitoli, intenti di ricerca e collegamenti interni ben costruiti.

Definisci anche una promessa professionale breve. “Scrivo contenuti SEO per software B2B” è più efficace di “Mi occupo di scrittura sul web”. Una specializzazione iniziale non ti impedisce di accettare altri lavori, ma aiuta i potenziali clienti a capire rapidamente quale problema puoi risolvere.

Selezionare e descrivere i progetti migliori

Ogni esempio dovrebbe essere accompagnato da un contesto minimo: settore, obiettivo, pubblico, formato e attività svolte. Indica se ti sei occupato di ricerca delle parole chiave, scaletta, stesura, ottimizzazione on-page, revisione o aggiornamento di un contenuto già pubblicato. Il lettore deve distinguere ciò che hai prodotto personalmente dal lavoro svolto da un intero team.

Quando possibile, aggiungi risultati verificabili. Un aumento del traffico organico, una crescita delle impressioni, più iscrizioni a una newsletter o un miglioramento del posizionamento rendono il caso più concreto. Non attribuirti risultati che non puoi documentare e non divulgare dati riservati. Puoi usare intervalli, percentuali approssimative autorizzate o descrizioni qualitative, come “il contenuto è entrato nella prima pagina per la keyword principale”.

Un buon portfolio alterna lavori diversi, senza trasformarsi in un archivio dispersivo. Inserisci tre o sei progetti solidi, organizzati per tipologia: articolo SEO, pagina commerciale, newsletter, case study o contenuto social. Per ogni progetto, mostra un estratto significativo e collega il testo pubblicato quando il cliente lo consente. Una breve analisi del processo spesso comunica più competenza di una semplice lista di link.

Costruire una vetrina ordinata su GitHub

Su GitHub puoi creare un repository pubblico dedicato al portfolio. Il file README.md funziona come pagina principale: aprilo con una presentazione sintetica, i servizi offerti, le aree tematiche e i recapiti professionali. Usa titoli Markdown, paragrafi brevi e collegamenti leggibili. Una struttura lineare permette a un recruiter o a un cliente di trovare subito gli esempi più pertinenti.

Puoi dedicare una cartella a ogni progetto e inserire al suo interno un file README con il brief, la soluzione editoriale e il risultato. Per esempio, una cartella chiamata “guida-seo-fintech” può contenere una scheda con intento di ricerca, struttura dell’articolo, estratto e link alla pubblicazione. Se lavori su revisioni successive, la cronologia delle modifiche mostra il tuo metodo e rende visibile l’evoluzione del testo.

GitHub richiede attenzione alla privacy. Non caricare bozze coperte da accordi di riservatezza, dati del cliente, credenziali o documenti interni. Per i progetti non pubblicabili, crea una versione anonimizzata: sostituisci il nome dell’azienda, modifica i numeri sensibili e presenta soltanto le competenze utilizzate. Controlla anche i permessi del repository prima di condividere il link.

Progettare una pagina professionale in Notion

Notion è adatto a chi desidera un portfolio simile a un mini-sito. Crea una home con nome, specializzazione, servizi, bio breve e pulsante di contatto. Subito dopo, inserisci una sezione dedicata ai lavori selezionati. Le copertine, le icone e i divisori possono migliorare la scansione visiva, ma non devono prevalere sul testo: la leggibilità resta il criterio principale.

Un database Notion consente di filtrare i progetti per formato, settore o competenza. Puoi aggiungere proprietà come “articolo SEO”, “copywriting”, “B2B”, “newsletter” e “pubblicato”. Ogni scheda può contenere il brief, il tuo ruolo, il link al contenuto, una breve riflessione e l’eventuale risultato. Questa impostazione rende semplice aggiornare il portfolio quando acquisisci un nuovo cliente o termini un progetto rilevante.

Usa una gerarchia coerente per tutte le schede. Il titolo deve spiegare subito il contenuto, mentre le prime righe devono chiarire perché quell’esempio merita attenzione. Se vuoi dimostrare competenze di content strategy, puoi collegare un caso studio a una risorsa sulla strategia pillar e cluster, spiegando come hai organizzato gli argomenti e i collegamenti interni. Prima di condividere la pagina, aprila in modalità visitatore e verifica che i link funzionino anche senza accesso al tuo account.

Rendere il portfolio utile per trovare clienti

Il portfolio deve guidare il visitatore verso un’azione chiara: scriverti, fissare una call o richiedere un preventivo. Inserisci un indirizzo email professionale e una frase precisa sui lavori disponibili. Puoi indicare anche il tuo processo, dai primi chiarimenti sul brief alla consegna e alle revisioni. Le informazioni sui prezzi vanno valutate caso per caso: una tariffa indicativa può qualificare i contatti, mentre un listino rigido potrebbe non adattarsi a progetti molto diversi.

Rileggi ogni pagina pensando alla ricerca organica e all’esperienza dell’utente. Usa termini naturali come “web writer freelance”, “articoli SEO”, “copywriting per aziende” e “contenuti per blog”, senza riempire il testo di parole chiave. Se produci molte pagine, uno strumento di assistenza alla scrittura come Wrizard può aiutarti a controllare struttura, leggibilità e ottimizzazione, lasciando a te le decisioni editoriali e la verifica delle fonti.

GitHub e Notion hanno punti di forza differenti. La scelta diventa più semplice confrontando il tipo di presentazione, la manutenzione richiesta e il pubblico a cui ti rivolgi.

Criterio	GitHub	Notion
Presentazione	Essenziale, tecnica e basata su Markdown	Visuale, flessibile e simile a un sito
Organizzazione	Repository, cartelle e cronologia delle modifiche	Pagine, database, filtri e proprietà
Ideale per	Writer tecnici, progetti strutturati e workflow documentati	Freelance, consulenti e portfolio narrativi
Aggiornamento	Richiede familiarità con file e commit	Rapido tramite editor visuale
Percezione	Metodo, precisione e competenze digitali	Accessibilità, cura grafica e immediatezza
Attenzione principale	Privacy dei repository e chiarezza del README	Permessi di condivisione e velocità di caricamento

Mantieni il portfolio aggiornato, elimina gli esempi superati e controlla periodicamente i collegamenti esterni. Una raccolta breve, coerente e orientata al cliente trasmette affidabilità molto più di una pagina piena di lavori senza contesto.