Stai rivedendo una pagina del sito e qualcuno ti chiede di «aggiungere il markup»: di solito si riferisce ai marcatori che descrivono il contenuto, ma in un preventivo o in un listino la stessa parola può indicare un margine sul costo. Il significato di markup dipende quindi dal contesto, e confondere i due usi può portare a intervenire sulla parte sbagliata del progetto.

Nel web il markup dà un ruolo a ogni contenuto

Una frase può sembrare un titolo perché è grande e in grassetto, ma il browser ha bisogno di un’indicazione più affidabile. Con un elemento come

, il codice dichiara che quella frase è il titolo principale; con

, identifica un paragrafo. Il markup descrive la struttura e il senso, mentre il foglio di stile decide l’aspetto.

Il browser interpreta i tag e costruisce una rappresentazione della pagina chiamata DOM, cioè una struttura ad albero che software e strumenti possono elaborare. La distinzione è utile anche per un sito aziendale: se un titolo è marcato solo con una dimensione del carattere, un lettore di schermo o un altro sistema potrebbe non riconoscerne la funzione. La forma visiva, da sola, non racconta tutta la storia.

Nel documento HTML, il markup è fatto di elementi, attributi e testo. La specifica HTML del WHATWG descrive gli elementi e le regole per combinarli; tra gli esempi ci sono

per un contenuto autonomo e per un’area di navigazione. Io distinguo sempre la domanda «che cos’è questo contenuto?» da «come deve apparire?»: la prima riguarda il markup, la seconda il CSS.

Markup non vuol dire sempre codice web

La parola cambia strada appena si passa dal codice ai conti. In un testo tecnico, «markup» indica spesso le marcature che organizzano un documento; in un listino o in un calcolo di prezzo può indicare il ricarico applicato al costo. La frase «aumentiamo il markup» è quindi ambigua finché non si sa se si parla del sito o del prezzo.

Un caso semplice: durante una riunione, chi sviluppa propone di aggiungere il markup semantico alla pagina del catalogo, mentre chi prepara i prezzi discute il markup commerciale. Nel primo caso si interviene sul codice; nel secondo, sul metodo con cui si forma il prezzo. Prima di assegnare il lavoro, chiedi quale contenuto o quale costo va marcato.

HTML, Markdown e dati strutturati hanno scopi diversi

Un file con parole tra parentesi angolari e uno con simboli come asterischi o cancelletto possono sembrare due varianti dello stesso sistema. In realtà, HTML e Markdown hanno sintassi e usi distinti: HTML definisce gli elementi di una pagina web, mentre Markdown usa convenzioni testuali leggere per formattare documenti, che spesso vengono poi convertiti in HTML.

C’è poi un terzo livello: i dati strutturati, che descrivono informazioni specifiche come un prodotto, un’organizzazione o un evento. Schema.org fornisce un vocabolario condiviso; JSON-LD, Microdata e RDFa sono formati per esprimere quei dati. Google Search Central raccomanda JSON-LD quando l’impostazione del sito lo consente e precisa che un markup valido non garantisce la visualizzazione di un risultato avanzato.

La regola pratica è netta: se vuoi organizzare titoli e sezioni, lavora sul markup HTML; se vuoi cambiare colori e spaziature, intervieni sul CSS; se vuoi descrivere dati leggibili anche dai software, valuta un formato di dati strutturati. Usa ciascun livello per il compito che gli spetta, così eviti di caricare una sola parte del sito di responsabilità diverse.

Un catalogo coerente evita correzioni duplicate

Immagina una pagina prodotto con nome, prezzo e disponibilità visibili alle persone. Se aggiungi dati strutturati, le informazioni devono corrispondere a ciò che la pagina mostra: un prezzo aggiornato nel codice ma vecchio a schermo crea una discrepanza, non una pagina più chiara. La coerenza tra contenuto visibile e dati descrittivi è il controllo da fare prima di pubblicare.

Per un’azienda che aggiorna molti prodotti, separare i dati dal modo in cui vengono presentati può rendere più semplice riutilizzarli nel sito, nei cataloghi e nei processi interni. La sostenibilità digitale passa anche da qui: meno copie manuali dello stesso dato significano meno occasioni di correggere la stessa informazione in più punti. Un markup ben scelto aiuta a mantenere ordine, ma non sostituisce una fonte affidabile per i dati.

La domanda giusta fa risparmiare un passaggio

Quando compare la parola «markup» in una richiesta, fermati un momento e chiarisci l’oggetto: struttura della pagina, descrizione dei dati o ricarico sul costo? Se la risposta riguarda il sito, specifica anche quale informazione deve diventare più leggibile e per chi: browser, tecnologie assistive, software aziendali o motori di ricerca.

È una piccola verifica prima di aprire il codice o modificare un listino. Evita che una richiesta vaga si trasformi in un intervento tecnico corretto, ma sul problema sbagliato.