Om documenten te publiceren als een statische site, vraag je een AI‑agent om ze te converteren naar Markdown met YAML‑front‑matter en afbeeldingen opgeslagen als bestanden, en voer vervolgens je generator uit. GroupDocs.Markdown.Mcp voert de conversie lokaal uit, zodat Claude Desktop, Claude Code, Cursor of GitHub Copilot Word-, Excel- en e‑book‑inhoud kunnen voorbereiden voor Hugo, Jekyll, MkDocs of Docusaurus zonder deze naar een service te sturen:

Converteer deze documenten naar Markdown met front‑matter, GitHub‑flavour, en afbeeldingen opgeslagen als bestanden.

De stap‑voor‑stap versie met configuratie en probleemoplossing staat in de documentatie: Hoe documenten te publiceren naar een statische site als Markdown.

Wat heeft een static‑site‑generator nodig van een document?

Drie dingen: Markdown voor de inhoud, YAML‑front‑matter voor de metadata, en afbeeldingen als bestanden op relatieve paden. Hugo, Jekyll, MkDocs en Docusaurus lezen allemaal front‑matter. convert_to_markdown produceert alle drie wanneer je de opties ervoor kiest:

Optie Waarde voor een site Wat het doet
frontMatter true Schrijft YAML met titel, auteur, formaat en paginatelling bovenaan het bestand
images "file" Schrijft afbeeldingen naast het .md‑bestand en verwijst ernaar via een relatief pad
flavor "github" (standaard), of "commonmark" GitHub‑flavoured Markdown is wat de meeste generators aannemen; CommonMark past bij een strengere toolchain

Controleer de titel en auteur bovenaan elk geconverteerd bestand; als ze leeg of onjuist zijn, vraag de agent ze in te stellen.

Hoe converteer ik Word naar Hugo‑Markdown?

Hugo is de generator achter deze blog, dus is het hier het voorbeeld. De workflow heeft vier stappen, en de agent voert ze allemaal uit.

  1. Convert. Voer de bovenstaande prompt uit op de map met documenten.
  2. Arrange. De server schrijft bestanden; de lay-out is de taak van de agent.

    Plaats elk geconverteerd bestand in een map met de naam van het document, met de afbeeldingen in een images submap ernaast.

  3. Add the keys the theme wants. Hugo‑thema’s verwachten vaak date of weight. Het hulpmiddel schrijft ze niet, dus vraag:

    Voeg weight toe aan de front‑matter van elk bestand, genummerd in de volgorde waarin ik ze heb opgesomd.

  4. Build. Voer Hugo zelf uit. Op dit punt zijn de bestanden gewone Markdown met front‑matter, en behandelt de generator ze als elke andere pagina.

Voor Docusaurus en MkDocs geldt dezelfde output; alleen de mapstructuur en de extra sleutels verschillen, en je beschrijft ze in de tweede en derde prompts.

Voorbeeldsessie (verkort)

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.

Hoe controleer ik het resultaat voordat ik publiceer?

Twee controles vangen bijna elk probleem:

Voor elk geconverteerd bestand, vergelijk het paginacontrole van de bron met de lengte van de Markdown.

Een document van 60 pagina’s dat 3 KB Markdown werd, is een gescande PDF of een uitvoering in evaluatiemodus.

Lijst de afbeeldingsmap van elk document en de afbeeldingen waar de Markdown naar verwijst.

Een .md die naar afbeeldingen verwijst die nooit zijn geschreven, wordt weergegeven als kapotte afbeeldingen op de site. Controleer de rommeligste bron voordat je een batch van tweehonderd verwerkt.

Word‑ en Excel‑bronnen worden geconverteerd met hun structuur intact: koppen blijven koppen en tabellen worden Markdown‑tabellen. PDF’s hangen af van hoe ze zijn gemaakt. Een digitaal geëxporteerd bestand converteert netjes; een scan converteert niet op een bruikbare manier, omdat deze server geen OCR‑stap heeft.

Welke front‑matter‑sleutels voeg ik zelf toe?

frontMatter: true schrijft titel, auteur, formaat en paginatelling. Controleer die waarden in elk bestand en vraag de agent eventuele lege of onjuiste waarden te corrigeren. Navigatie, volgorde, tags en datums zijn sleutels die je na de conversie toevoegt, zoals in stap 3. Om rijkere documenteigenschappen in de front‑matter op te nemen, combineer je deze server met GroupDocs.Metadata.Mcp, die ze leest, en laat je de agent de sleutels toevoegen; dit bericht behandelt dat niet.

Eerlijke beperkingen

Zonder licentie draait de server in evaluatiemodus, en worden alleen de eerste 3 pagina’s verwerkt, met een evaluatiewatermerk op elke pagina. Een site gebouwd op niet‑gelicentieerde output levert drie‑pagina‑stubs van lange documenten. Voer get_license_status uit voordat je converteert, en houd de controle “lengte versus bron” in de lus.

Veelgestelde vragen

Hoe converteer ik Word naar Hugo‑Markdown?

Vraag de agent om het document te converteren met frontMatter: true, images: "file" en flavor: "github", en vervolgens de bestanden in je content‑map te rangschikken. Voeg eventuele themaspecifieke sleutels, zoals weight, toe in een tweede prompt.

Kan een AI‑agent documenten publiceren naar een statische site?

Hij kan alles voorbereiden wat de site‑build nodig heeft: Markdown, front‑matter, afbeeldingsbestanden en mapstructuur. Jij voert de generator uit, zodat de build en de implementatie onder jouw controle blijven.

Gebeurt de conversie lokaal?

Ja. GroupDocs.Markdown.Mcp draait als een lokaal proces via stdio en leest de documenten uit de map die je hebt geconfigureerd. Documenten die pas na beoordeling openbaar worden, blijven op je machine totdat je ze publiceert.

Ga dieper