Per pubblicare documenti come sito statico, chiedi a un agente IA di convertirli in Markdown con front matter YAML e immagini salvate come file, quindi esegui il tuo generatore. GroupDocs.Markdown.Mcp esegue la conversione localmente, così Claude Desktop, Claude Code, Cursor o GitHub Copilot possono preparare contenuti Word, Excel e e‑book per Hugo, Jekyll, MkDocs o Docusaurus senza inviarli a un servizio:

Converti questi documenti in Markdown con front matter, flavor GitHub e immagini salvate come file.

La versione passo‑passo con configurazione e risoluzione dei problemi è nella documentazione: Come pubblicare documenti su un sito statico come Markdown.

Cosa necessita un generatore di siti statici da un documento?

Tre cose: Markdown per il corpo, front matter YAML per i metadati e immagini come file con percorsi relativi. Hugo, Jekyll, MkDocs e Docusaurus leggono tutti il front matter. convert_to_markdown produce tutti e tre quando scegli le opzioni per esso:

Opzione Valore per un sito Cosa fa
frontMatter true Scrive YAML con titolo, autore, formato e conteggio pagine in cima al file
images "file" Scrive le immagini accanto al .md e le riferisce con percorsi relativi
flavor "github" (default), or "commonmark" Il Markdown con flavor GitHub è quello che la maggior parte dei generatori assume; CommonMark è adatto a una catena di strumenti più rigorosa

Controlla il titolo e l’autore in cima a ogni file convertito; se sono vuoti o errati, chiedi all’agente di impostarli.

Come converto Word in Markdown per Hugo?

Hugo è il generatore dietro questo blog, quindi è l’esempio qui. Il flusso ha quattro passaggi, e l’agente li esegue tutti.

  1. Converti. Esegui il prompt sopra sulla cartella dei documenti.
  2. Organizza. Il server scrive i file; la disposizione è compito dell’agente.

    Metti ogni file convertito in una cartella chiamata come il documento, con le sue immagini in una sottocartella images accanto.

  3. Aggiungi le chiavi richieste dal tema. I temi Hugo spesso si aspettano date o weight. Lo strumento non le scrive, quindi chiedi:

    Aggiungi weight al front matter di ogni file, numerato nell’ordine in cui li ho elencati.

  4. Compila. Esegui Hugo tu stesso. A questo punto i file sono Markdown ordinario con front matter, e il generatore li tratta come qualsiasi pagina.

Per Docusaurus e MkDocs si applica lo stesso output; solo la disposizione delle cartelle e le chiavi extra differiscono, e le descrivi nel secondo e terzo prompt.

Sessione di esempio (abbreviata)

You:   Convert the three documents in /drafts to Markdown with front matter, GitHub
       flavour, and images as files. One folder per document.
Agent: convert_to_markdown (frontMatter: true, flavor: "github", images: "file") x 3
       Created guide-onboarding/, guide-security/, price-list/ with .md files and
       images subfolders. Front matter holds title, author, format and page count.
You:   Add weight to each file in the order I listed them.
Agent: Updated the front matter of the three files with weight 10, 20 and 30.

Come verifico il risultato prima di pubblicare?

Due verifiche catturano quasi tutti i problemi:

Per ogni file convertito, confronta il conteggio delle pagine dell’originale con la lunghezza del Markdown.

Un documento di 60 pagine che è diventato 3 KB di Markdown è un PDF scansionato o un’esecuzione in modalità valutazione.

Elenca la cartella delle immagini di ogni documento e le immagini a cui il suo Markdown fa riferimento.

Un .md che fa riferimento a immagini mai scritte appare come immagini rotte sul sito. Controlla rapidamente la fonte più caotica prima di un batch di duecento.

Le fonti Word e Excel si convertono con la struttura intatta: le intestazioni diventano intestazioni e le tabelle diventano tabelle Markdown. I PDF dipendono da come sono stati prodotti. Un’esportazione nativa digitale si converte pulitamente; una scansione non si converte in modo utile, perché questo server non ha un passaggio OCR.

Quali chiavi del front matter aggiungo io?

frontMatter: true scrive titolo, autore, formato e conteggio pagine. Controlla quei valori in ogni file e chiedi all’agente di correggere quelli vuoti o errati. Navigazione, ordinamento, tag e date sono chiavi che aggiungi dopo la conversione, come nel passo 3. Per inserire proprietà del documento più ricche nel front matter, abbina questo server a GroupDocs.Metadata.Mcp, che le legge, e fai aggiungere le chiavi all’agente; questo post non lo copre.

Limiti onesti

Senza licenza il server funziona in modalità valutazione, e vengono elaborate solo le prime 3 pagine, con una filigrana di valutazione su ciascuna. Un sito costruito da output non licenziato fornisce stub di tre pagine di documenti lunghi. Esegui get_license_status prima di convertire, e mantieni il controllo “lunghezza rispetto alla sorgente” nel ciclo.

FAQ

Come converto Word in Markdown per Hugo?

Chiedi all’agente di convertire il documento con frontMatter: true, images: "file" e flavor: "github", poi di organizzare i file nella tua cartella di contenuti. Aggiungi eventuali chiavi specifiche del tema, come weight, in un secondo prompt.

Un agente IA può pubblicare documenti su un sito statico?

Può preparare tutto ciò di cui la compilazione del sito ha bisogno: Markdown, front matter, file immagine e disposizione delle cartelle. Tu esegui il generatore, quindi la compilazione e il deployment rimangono sotto il tuo controllo.

La conversione avviene localmente?

Sì. GroupDocs.Markdown.Mcp viene eseguito come processo locale su stdio e legge i documenti dalla cartella che hai configurato. I documenti che diventano pubblici solo dopo la revisione rimangono sulla tua macchina fino a quando non li pubblichi.

Approfondisci