L'approccio di lavoro
Streamdown aiuta un agente a integrare un renderer React Markdown progettato per contenuti che arrivano progressivamente. Copre modalità streaming e statica, evidenziazione del codice, diagrammi, notazione matematica e testo CJK. Spiega anche controlli sul contenuto renderizzato: copia, link e gestione di elementi personalizzati.
Il valore pratico è nei dettagli d’integrazione facili da trascurare. La fonte evidenzia la scansione Tailwind dei file dei pacchetti, gli stili KaTeX per la matematica e la relazione tra cursore di streaming e isAnimating. I plugin opzionali si aggiungono in base ai contenuti realmente necessari all’interfaccia.
Risultati attesi
- Un renderer Streamdown collegato al Markdown dell’applicazione.
- Configurazione di plugin e Tailwind adeguata ai pacchetti installati.
- Scelte esplicite su conferma dei link, elementi consentiti e controlli interattivi.
Dal brief alla revisione
- 01Scegliere le capacità dei contenuti
Individua se servono codice, Mermaid, matematica o CJK. Scegli streaming per risposte incrementali o modalità statica per documenti completi.
- 02Configurare rendering e stili
Installa i pacchetti scelti e includi i file di distribuzione nella scansione Tailwind. Tailwind v4 usa direttive @source; v3 usa voci content nella configurazione. Aggiungi percorsi soltanto per plugin installati. Importa CSS KaTeX per la matematica, poi collega il renderer alla struttura attuale dei messaggi.
- 03Verificare streaming e sicurezza
Imposta lo stato di animazione della risposta attiva e controlla HTML personalizzato, gestione URL e conferma dei link. Esamina risposte incomplete e contenuti finiti.