Markdown per agenti

Panoramica

Markdown per agenti crea versioni markdown ottimizzate per AI dei contenuti pubblicati. È utile per team che vogliono un output più pulito per crawler AI, flussi di lavoro con agenti o esportazioni verso knowledge base.

Percorso amministrazione: Airygen SEO -> Impostazioni -> Markdown per agenti

Il modulo ti permette di controllare l’output markdown, scegliere quali tipi di contenuto includere, rigenerare gli snapshot, visualizzare anteprime per ID post e aggiungere prompt a livello di singolo contenuto direttamente nell’editor.

Impostazioni

La pagina è divisa in Impostazioni, Snapshot e Anteprima.

Scheda Impostazioni

Questa scheda controlla il comportamento generale dell’output markdown e i metadati inclusi.

• Abilita output Markdown attiva o disattiva l’esportazione markdown del contenuto pubblicato.
• Abilita output Markdown consente anche di servire l’output markdown ai client AI tramite intestazioni o query di formato quando il modulo è attivo.
• Prompt per agenti mostra nell’editor un pannello in cui puoi aggiungere descrizioni, istruzioni o prompt per gli agenti LLM.
• Includi YAML front matter aggiunge in cima al markdown metadati come titolo, autore, data di pubblicazione, URL canonico e keyphrase.

La sezione Ambito definisce quali contenuti possono essere esportati.

• Tipi di post da includere decide quali tipi di post pubblici vengono esportati in markdown.

Scheda Snapshot

Questa scheda serve per controllare ciò che è già stato generato e per rigenerare gli export esistenti.

• Ricostruisci rigenera gli snapshot markdown in background.
• Filtro tipo di post limita la tabella agli elementi del tipo di post selezionato nell’ambito attivo.
• La tabella degli snapshot mostra ID Articolo, Titolo, Tipo di post e Ultima sincronizzazione.
• Visualizza apre la versione markdown del contenuto corrispondente.
• I controlli di paginazione Precedente e Successivo ti aiutano a passare da una pagina di snapshot all’altra.

Scheda Anteprima

Questa scheda ti permette di verificare l’output markdown prima di usarlo nel tuo flusso di lavoro.

• ID Articolo carica l’anteprima markdown per uno specifico contenuto pubblicato.
• Anteprima genera l’output usando le impostazioni correnti del modulo.
• Output mostra il markdown generato in un’area di testo di sola lettura.

Pannello dell’editor

Quando Prompt per agenti è abilitato, l’editor mostra un campo Prompt per agenti per ogni contenuto supportato.

• Usa questo campo per aggiungere descrizioni, istruzioni o prompt specifici per gli agenti LLM.
• Il pannello è utile quando una pagina ha bisogno di contesto aggiuntivo che non vuoi inserire nel contenuto visibile ai lettori.

Come si usa

1. Apri Airygen SEO -> Impostazioni -> Markdown per agenti.
2. Attiva Abilita output Markdown.
3. Decidi se vuoi mostrare Prompt per agenti nell’editor per consentire istruzioni aggiuntive a livello di singolo contenuto.
4. Decidi se attivare Includi YAML front matter in base a quante informazioni vuoi includere in cima al file markdown.
5. Nella sezione Ambito, seleziona in Tipi di post da includere i tipi di contenuto che vuoi esportare.
6. Salva le modifiche del modulo.
7. Apri la scheda Snapshot e clicca Ricostruisci se vuoi rigenerare subito gli snapshot dei contenuti esistenti.
8. Usa Filtro tipo di post e la tabella degli snapshot per verificare quali contenuti hanno già un export disponibile.
9. Apri la scheda Anteprima, inserisci un ID Articolo pubblicato e clicca Anteprima per controllare il markdown generato con le impostazioni correnti.
10. Se hai abilitato Prompt per agenti, apri un contenuto nell’editor e aggiungi eventuali istruzioni specifiche nel campo Prompt per agenti.
11. Apri uno snapshot con Visualizza oppure aggiungi ?format=md a un URL supportato per verificare l’output markdown pubblico.

Controlla questi elementi dopo il salvataggio:

• L’output markdown è attivo solo per i tipi di post che vuoi davvero esporre.
• Il blocco YAML compare solo quando Includi YAML front matter è attivato.
• Gli snapshot mostrano tempi di sincronizzazione aggiornati dopo una ricostruzione.
• L’output markdown include solo i prompt per agenti che hai aggiunto intenzionalmente.

Vantaggi SEO

Questo modulo non modifica direttamente il posizionamento, ma crea una versione dei contenuti più pulita e leggibile dalle macchine. Questo può rendere più coerenti i flussi di lavoro basati su AI e semplificare la gestione di esportazioni markdown dei tuoi contenuti.

Casi d’uso

Team che pubblicano contenuti pensati per strumenti AI

Prima: Un team ha documentazione o articoli informativi, ma l’HTML standard include elementi di pagina che complicano l’uso del contenuto nei flussi markdown.

Dopo: Markdown per agenti fornisce una versione più pulita e facile da controllare, esportare e riutilizzare in workflow AI.

Agenzie che vogliono aggiungere istruzioni specifiche per singola pagina

Prima: Alcune pagine richiedono contesto aggiuntivo per agenti AI, ma non esiste un punto ordinato in cui salvarlo senza modificare il testo pubblico.

Dopo: Il pannello Prompt per agenti permette all’agenzia di aggiungere istruzioni dedicate senza riscrivere l’articolo visibile ai visitatori.

Domande frequenti

Questo modulo cambia la normale pagina HTML che vedono i visitatori?

No. Aggiunge un output markdown per i flussi supportati, ma non sostituisce la normale visualizzazione HTML della pagina.

Che cosa aggiunge Includi YAML front matter?

Aggiunge metadati in cima al file, come titolo, autore, data di pubblicazione, URL canonico e informazioni sulla keyphrase.

Posso controllare un solo contenuto prima di usare il modulo su scala più ampia?

Sì. Usa la scheda Anteprima, inserisci un ID Articolo pubblicato e rivedi il markdown generato prima di estendere il flusso ad altri contenuti.

A cosa servono gli Snapshot?

Gli Snapshot ti aiutano a vedere quali contenuti hanno già una versione markdown generata e ti permettono di ricostruirli quando aggiorni le impostazioni del modulo.