Formato documentale aperto · Core 0.1 bozza
Web Document Format (.wdf) Ciò che leggi è ciò che legge l’AI.
WDF è un formato documentale aperto e nativo del web, pensato per l’accessibilità: leggibile su qualsiasi schermo, comprensibile alle macchine (i bot di AI), verificabile per costruzione. Un solo file porta il testo, i dati e il documento originale — e prova che coincidono.
- Pensato per l’accessibilità — fatto per la pubblica amministrazione
- ZIP + HTML + JSON, niente di inventato
- Integrità SHA-256, verificata offline
- Spec CC-BY 4.0 · Codice Apache-2.0
Perché?
Oggi un documento ha due pubblici. Le persone e gli agenti. Ogni formato in cui pubblichiamo è stato progettato per uno solo dei due.
Il lettore è cambiato. Il formato no.
Il PDF congela la vista di stampa e butta via la struttura che il documento aveva mentre veniva scritto. Una pagina web conserva la struttura, ma non è un file: cambia sotto la tua citazione e muore con il suo server.
Nessun parser porta a una prova.
Un’intera industria ricostruisce a tentoni la struttura dei PDF prima di darli ai modelli linguistici. Un parser ti dà un’interpretazione. Nessuna pipeline può provare che ciò che la macchina ha letto è ciò che hai visto tu.
Tieni il PDF. Guadagni il resto.
WDF non combatte il mondo di prima. Il PDF dell’autore e il file Word originale viaggiano dentro il pacchetto, accanto alla struttura vera — così niente di ciò che consegni oggi va perso.
Pensato per l’accessibilità.
Gli enti pubblici devono pubblicare documenti che tutti possano leggere — su un telefono, con un lettore di schermo, a qualsiasi ingrandimento (Direttiva UE 2016/2102, European Accessibility Act). Un WDF è HTML semantico su una lista chiusa di elementi ammessi: titoli, elenchi, tabelle vere, testo che si riadatta, testo alternativo obbligatorio. La struttura c’è fin dall’inizio, non va aggiunta dopo; ciò che resta — descrizioni, contrasto, linguaggio chiaro — rimane compito dell’autore, e resta verificabile.
Dal vivo
Il Reader, con dentro un documento vero.
Passa da Umano ad Agente, clicca un paragrafo qualsiasi, copia una citazione: lo stesso elemento si illumina in entrambe le viste. Il bollino dice che il file è stato verificato — qui, sul tuo computer, senza nessun server.
Un decreto comunale di fantasia, scritto per la dimostrazione (in inglese). Apri a schermo intero →
-
Decreto comunale
Una tabella di impegni tipizzata, legata a
data/commitments.json. -
Rapporto energetico
Due tabelle legate a dataset e un grafico SVG disegnato dagli stessi valori.
-
Articolo tecnico
Blocchi di codice, una figura, un glossario — e la sua storia di verifica.
Cosa c’è nel file
Un file, ogni lettore.
-
Un solo file
Testo, dati tipizzati e documento originale viaggiano insieme in un unico
.wdfportabile. -
Verificato
Impronte SHA-256 e una derivazione deterministica al byte. Si verifica offline, senza dover interpellare alcuna autorità.
-
AI e MCP
Gli agenti si collegano alla struttura attraverso il server MCP. Non ne raschiano mai un’immagine.
-
Qualsiasi schermo
Testo vero che si riadatta su telefono, tablet e computer — e viene letto ad alta voce correttamente.
-
Citazioni che portano al punto
Un URI
wdf:apre esattamente il paragrafo da cui viene. Non “pagina 2”. -
Dati tipizzati
Le tabelle sono legate a dataset tipizzati: numeri su cui fare calcoli, non disegni di cifre.
-
.wdf + vista PDF
Il PDF dell’autore viaggia dentro e si vede nella vista Originale, identico alla carta.
-
.wdf + originale da scaricare
Dentro c’è anche il file Word, e ne esce identico.
-
Salva la pagina
L’estensione per il browser trasforma qualsiasi pagina web in un file verificabile da inviare. Scaricala per Chrome →
-
Funziona offline
Un documento non tocca mai la rete. Né per aprirlo, né per verificarlo. Mai.
-
Accessibile
HTML semantico su una lista chiusa di elementi ammessi: la struttura che serve all’accessibilità, costruita dentro anziché aggiunta dopo.
-
Formato aperto
Spec CC-BY 4.0, implementazione di riferimento Apache-2.0. Niente licenze da comprare, nessuno a cui chiedere.
Ideale per
Dove i vecchi formati fanno più male.
Pubblica amministrazione
Documenti pubblici che tutti possono leggere
Decreti, relazioni, bandi: leggibili su un telefono, verificabili da qualsiasi cittadino, con dentro il PDF per l’archivio. La struttura che le regole sull’accessibilità richiedono, già costruita.
Web
Salvi una pagina, mandi un file
Un clic nel browser trasforma l’articolo che stai leggendo in un documento che si apre ovunque e dichiara da dove viene. Fine dei link morti.
AI
Basi di conoscenza che citano
Un fascicolo convertito in WDF dà a un agente identificatori stabili e citazioni verificabili attraverso MCP — niente parsing, niente numeri di pagina inventati.
Ufficio
Pubblica un documento Word, in modo nuovo
Entra relazione.docx, esce relazione.wdf: struttura,
tabelle tipizzate, il file originale e il PDF dell’autore, tutto in un pacchetto.
Per iniziare
Tre modi per cominciare.
Leggi
WDF Reader
Un’app installabile: trascina un .wdf, un .docx o
un’esportazione HTML, leggilo, verificalo, citalo. Una volta installata funziona
offline.
Clicca Installa nel Reader (Chrome, Edge). Da quel momento i file .wdf si aprono con un doppio clic.
Salva
Estensione per il browser
Save as WDF cattura la pagina che stai guardando come .wdf o
come .wdf.html autonomo, con il lettore incorporato. Nessun server,
nessun dato raccolto.
Costruisci
Strumenti su npm
Valida, converti ed estrai da riga di comando, nella CI o dal tuo codice. Stesso input, pacchetto identico al byte su qualsiasi piattaforma.
# valida qualsiasi documento npx @wdf-dev/cli validate documento.wdf # Word → WDF, con l’originale e il suo PDF npx @wdf-dev/cli import relazione.docx \ --with-source --with-pdf relazione.pdf # dai il documento a un agente claude mcp add wdf -- npx -y @wdf-dev/mcp
Codice su GitHub · Spec, ~20 pagine (in inglese) · PDF contro WDF, un solo prompt (in inglese)