Um Dokumente als statische Website zu veröffentlichen, lassen Sie einen KI‑Agenten sie in Markdown mit YAML‑Front‑Matter und als Dateien gespeicherten Bildern konvertieren und führen dann Ihren Generator aus. GroupDocs.Markdown.Mcp führt die Konvertierung lokal aus, sodass Claude Desktop, Claude Code, Cursor oder GitHub Copilot Word‑, Excel‑ und E‑Book‑Inhalte für Hugo, Jekyll, MkDocs oder Docusaurus vorbereiten können, ohne sie an einen Dienst zu senden:

Konvertieren Sie diese Dokumente in Markdown mit Front‑Matter, GitHub‑Flavor und als Dateien gespeicherten Bildern.

Die schrittweise Version mit Konfiguration und Fehlersuche finden Sie in der Dokumentation: How to publish documents to a static site as Markdown.

Was benötigt ein statischer Website‑Generator von einem Dokument?

Drei Dinge: Markdown für den Inhalt, YAML‑Front‑Matter für die Metadaten und Bilder als Dateien mit relativen Pfaden. Hugo, Jekyll, MkDocs und Docusaurus lesen alle Front‑Matter. convert_to_markdown erzeugt alle drei, wenn Sie die Optionen dafür wählen:

Option Wert für die Seite Was es tut
frontMatter true Schreibt YAML mit Titel, Autor, Format und Seitenzahl am Anfang der Datei
images "file" Schreibt Bilder neben der .md und referenziert sie über relative Pfade
flavor "github" (default), oder "commonmark" GitHub‑flavoured Markdown ist das, was die meisten Generatoren erwarten; CommonMark passt zu einer strengeren Toolchain

Überprüfen Sie Titel und Autor am Anfang jeder konvertierten Datei; wenn sie leer oder falsch sind, lassen Sie den Agenten sie setzen.

Wie konvertiere ich Word zu Hugo‑Markdown?

Hugo ist der Generator hinter diesem Blog, daher ist es hier das Beispiel. Der Ablauf besteht aus vier Schritten, und der Agent führt alle aus.

  1. Konvertieren. Führen Sie die obige Eingabeaufforderung im Ordner mit den Dokumenten aus.
  2. Anordnen. Der Server schreibt Dateien; das Layout ist Aufgabe des Agenten.

    Legen Sie jede konvertierte Datei in einen Ordner, der nach dem Dokument benannt ist, und speichern Sie die Bilder in einem images‑Unterordner daneben.

  3. Fügen Sie die vom Theme gewünschten Schlüssel hinzu. Hugo‑Themes erwarten oft date oder weight. Das Tool schreibt sie nicht, also fragen Sie:

    Fügen Sie weight zum Front‑Matter jeder Datei hinzu, nummeriert in der Reihenfolge, in der ich sie aufgelistet habe.

  4. Erstellen. Führen Sie Hugo selbst aus. Zu diesem Zeitpunkt sind die Dateien gewöhnliches Markdown mit Front‑Matter, und der Generator behandelt sie wie jede andere Seite.

Für Docusaurus und MkDocs gilt dieselbe Ausgabe; nur das Ordner‑Layout und die zusätzlichen Schlüssel unterscheiden sich, und Sie beschreiben sie im zweiten und dritten Prompt.

Beispiel‑Sitzung (gekürzt)

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.

Wie prüfe ich das Ergebnis, bevor ich veröffentliche?

Zwei Prüfungen erfassen fast jedes Problem:

Für jede konvertierte Datei vergleichen Sie die Seitenzahl der Quelle mit der Länge des Markdown.

Ein 60‑seitiges Dokument, das zu 3 KB Markdown wurde, ist ein gescanntes PDF oder ein Lauf im Evaluationsmodus.

Listen Sie den Bildordner jedes Dokuments und die Bilder, auf die sein Markdown verweist, auf.

Eine .md, die auf nie geschriebene Bilder verweist, wird auf der Seite als defekte Bilder angezeigt. Prüfen Sie die unordentlichste Quelle, bevor Sie einen Stapel von zweihundert verarbeiten.

Word‑ und Excel‑Quellen konvertieren mit ihrer Struktur intakt: Überschriften werden zu Überschriften und Tabellen zu Markdown‑Tabellen. PDFs hängen davon ab, wie sie erstellt wurden. Ein digital erzeugter Export konvertiert sauber; ein Scan wird nicht sinnvoll konvertiert, da dieser Server keinen OCR‑Schritt hat.

Welche Front‑Matter‑Schlüssel füge ich selbst hinzu?

frontMatter: true schreibt Titel, Autor, Format und Seitenzahl. Überprüfen Sie diese Werte in jeder Datei und lassen Sie den Agenten alle leeren oder falschen korrigieren. Navigation, Reihenfolge, Tags und Daten sind Schlüssel, die Sie nach der Konvertierung hinzufügen, wie in Schritt 3. Um umfangreichere Dokumenteigenschaften in das Front‑Matter zu übernehmen, kombinieren Sie diesen Server mit GroupDocs.Metadata.Mcp, das sie ausliest, und lassen Sie den Agenten die Schlüssel hinzufügen; dieser Beitrag behandelt das nicht.

Ehrliche Grenzen

Ohne Lizenz läuft der Server im Evaluationsmodus und verarbeitet nur die ersten 3 Seiten, wobei jede mit einem Evaluations‑Wasserzeichen versehen ist. Eine aus unlizenzierten Ausgaben erstellte Website liefert dreiseitige Stub‑Versionen langer Dokumente. Führen Sie get_license_status aus, bevor Sie konvertieren, und behalten Sie die „Länge‑gegen‑Quelle“-Prüfung im Loop bei.

FAQ

Wie konvertiere ich Word zu Hugo‑Markdown?

Bitten Sie den Agenten, das Dokument mit frontMatter: true, images: "file" und flavor: "github" zu konvertieren und anschließend die Dateien in Ihrem Content‑Ordner anzuordnen. Fügen Sie in einem zweiten Prompt alle themenspezifischen Schlüssel, wie weight, hinzu.

Kann ein KI‑Agent Dokumente zu einer statischen Website veröffentlichen?

Er kann alles vorbereiten, was der Website‑Build benötigt: Markdown, Front‑Matter, Bilddateien und Ordner‑Layout. Sie führen den Generator aus, sodass Build und Deployment unter Ihrer Kontrolle bleiben.

Erfolgt die Konvertierung lokal?

Ja. GroupDocs.Markdown.Mcp läuft als lokaler Prozess über stdio und liest die Dokumente aus dem von Ihnen konfigurierten Ordner. Dokumente, die erst nach einer Überprüfung öffentlich werden, bleiben auf Ihrem Rechner, bis Sie sie veröffentlichen.

Weiterführende Informationen