Perché Theo vuole meno Markdown e più HTML

Markdown è diventato stretto

Theo apre con un gesto quasi di resa, perché riconosce che il Markdown resta utile, ma insiste sul fatto che il suo dominio si è allargato troppo. Dice di averlo amato per quasi due decenni, poi di aver iniziato a sentirlo come un vincolo quando i modelli sono diventati abbastanza capaci da produrre materiale più complesso di una pagina testuale. Per lui il cambio di scala è il punto: non si tratta più di scrivere note, ma di orchestrare lavoro tra umani e agenti.

I file Markdown sono diventati il formato dominante usato dagli agenti per comunicare con noi. È semplice, portabile, ha una certa capacità di testo ricco, ed è facile da modificare.

2:58

Ho iniziato a preferire HTML come formato di output invece di Markdown, e vedo sempre più persone del team Claude Code fare lo stesso.

3:15

L’argomento, però, non è nostalgico. Theo prova a dire che il Markdown resta buono finché il documento è corto, ma diventa un collo di bottiglia quando il contenuto deve includere diagrammi, interazioni, immagini o una gerarchia visiva più chiara. Perché gli agenti usano Markdown è il punto di partenza, non la conclusione: appena il file supera una certa soglia, sostiene, il formato smette di aiutare il lettore e comincia a servire soprattutto la pigrizia del flusso di lavoro.

L’HTML alza la densità

Il cuore della sua tesi è che l’HTML permetta di comprimere più informazione in un singolo artefatto. Theo cita tabelle, codice, immagini, flussi spaziali, CSS e componenti interattivi come prove di una maggiore capacità espressiva rispetto al Markdown, e sostiene che questo renda il lavoro dell’agente più utile e quello del lettore più esigente. In pratica, dice, un file HTML può diventare una mini interfaccia invece di restare un blocco di testo da scorrere.

Un singolo file HTML può contenere tabelle, design, illustrazioni, codice, immagini, flussi spaziali e interazioni. Buona fortuna a farlo con il Markdown.

8:04

Se il modello deve usare Markdown, spesso finisce per fare cose meno efficienti, come diagrammi fatti male o colori stimati con caratteri Unicode.

9:29

Qui Theo insiste sulla qualità dell’output, non solo sul formato. Per lui il problema non è che Markdown sia brutto, ma che spinga gli agenti verso soluzioni di ripiego quando serve mostrare strutture, confronti o dati complessi. Un file HTML può contenere tabelle, osserva, mentre il Markdown resta legato a una logica di pagina lineare che si indebolisce non appena il contenuto diventa multidimensionale.

Leggere, condividere, verificare

Theo dedica una lunga parte del video alla leggibilità. Dice di non riuscire a leggere con attenzione documenti Markdown molto lunghi, e di pensare che la stessa soglia valga per molte persone in un’organizzazione. L’HTML, nella sua lettura, migliora la navigazione, può essere reso responsive e può essere condiviso come link anziché come allegato scomodo.

In pratica, ho scoperto che non leggo davvero file Markdown di più di 100 righe, e non riesco certo a farli leggere a qualcun altro nella mia organizzazione.

10:05

Con l’HTML, finché carichi il file, per esempio su S3, puoi condividere facilmente il link. I colleghi possono aprirlo dove vogliono e consultarlo senza sforzo.

10:38

C’è però una tensione che Theo stesso non nasconde: alcuni esempi che cita non funzionano bene su mobile, e l’idea di una resa universale non è automatica. Qui il suo punto è più pragmatico che ideologico, perché ammette che ogni strato di accessibilità aggiunge peso e che parte del vantaggio si perde se l’HTML viene gonfiato troppo. La sua vera affermazione è più stretta: rispetto a un lungo testo di specifiche, un documento strutturato bene aumenta le probabilità che qualcuno lo apra e lo legga.

La probabilità che qualcuno legga davvero la tua specifica o la tua PR è molto più alta se è in HTML.

11:23

Interazione e contesto

La parte che entusiasma di più Theo è l’interazione. Gli piace l’idea che un documento non sia solo una superficie da leggere, ma un oggetto con slider, pulsanti, rami alternativi e pulsanti di esportazione verso un nuovo prompt. Per questo insiste sul fatto che l’HTML non serve solo a presentare risultati, ma anche a farli esplorare e modificare prima di rimandarli all’agente.

Puoi chiedergli di aggiungere slider o manopole per regolare il design, o permetterti di cambiare opzioni diverse dell’algoritmo per vedere cosa succede.

12:06

Molti sviluppatori sanno solo dire all’agente cosa vogliono loro, non come portarlo oltre la loro conoscenza per creare qualcosa destinato a qualcun altro.

23:59

Questa è una delle sue tesi più forti, perché sposta il problema dal formato al modo in cui si istruisce il modello. Theo sostiene che molti prompt falliscano perché restano intrappolati nella prospettiva dell’utente esperto, mentre un buon artefatto deve spesso essere pensato per un lettore inesperto o per un manager che vuole una sintesi affidabile. In questo senso, l’HTML diventa una macchina per cambiare pubblico, non solo per cambiare estetica.

Il vero vantaggio è mentale

Theo torna più volte su un punto meno glamour ma più persuasivo: l’HTML rende il processo più coinvolgente. Dice che costruire artefatti di questo tipo lo fa sentire più dentro il lavoro, più capace di iterare e più disposto a leggere davvero quello che il modello produce. È qui che il suo discorso diventa quasi etico, perché collega il formato non alla purezza tecnica ma alla qualità dell’attenzione.

La cosa più importante è che questo mi fa sentire molto più dentro il processo con Claude.

30:44

Se questo ti fa impegnare di più con l’output del tuo agente, così da ottenere risultati migliori e partecipare di più al processo, ha valore.

13:25

Qui il paragone con Vim e Neovim non è casuale. Theo dice che certi strumenti valgono non perché semplificano tutto, ma perché rendono più desiderabile l’atto stesso di lavorare, e quindi spingono a fare di più. Il rischio, naturalmente, è che una preferenza personale venga scambiata per una regola generale: lui lo ammette, ma la spinta del video resta quella di convertire una sensazione in metodo.

Il limite dei token e il futuro

Nella parte finale Theo affronta le obiezioni più ovvie, a cominciare da quella sui token. Dice di aver sentito l’accusa che tutto questo serva solo a far spendere più contesto agli utenti, ma la respinge: per lui l’HTML vale di più perché aumenta la probabilità che il documento venga davvero letto e quindi usato. Aggiunge che con finestre di contesto da un milione di token, il costo extra gli sembra meno importante di quanto si dica.

Il Markdown usa spesso meno token, ma io trovo che l’espressività aggiunta dell’HTML e la probabilità molto più alta che lo legga mi diano un risultato complessivamente migliore.

28:58

Siamo ancora lontani dal capire davvero le interfacce. Il fatto che siamo ancora così attaccati ai terminali mostra quanto siamo lontani dall’aver fatto bene.

34:43

Theo chiude con una previsione ampia, quasi speculativa: l’output dei modelli si muoverà sempre più verso interfacce visive, simulazioni e formati interattivi, mentre il terminale resterà una forma provvisoria. Cita anche Karpathy, che invita a chiedere HTML come risposta e poi vedere il file nel browser, e dice di condividere l’idea che il video, il layout e la grafica siano spesso il canale migliore per l’AI. Ma il suo punto più prudente è che HTML, per ora, non è la destinazione finale, solo un passo più serio del Markdown verso un modo migliore di far lavorare gli agenti.