Pro publikování dokumentů jako statické stránky požádejte AI agenta, aby je převedl do Markdown s YAML front matter a obrázky uloženými jako soubory, a poté spusťte svůj generátor. GroupDocs.Markdown.Mcp provádí konverzi lokálně, takže Claude Desktop, Claude Code, Cursor nebo GitHub Copilot mohou připravit obsah Word, Excel a e‑booků pro Hugo, Jekyll, MkDocs nebo Docusaurus, aniž by jej odesílali do služby:

Převést tyto dokumenty do Markdown s front matter, variantou GitHub a obrázky uloženými jako soubory.

Verze krok za krokem s konfigurací a řešením problémů je v dokumentaci: Jak publikovat dokumenty jako statickou stránku v Markdownu.

Co potřebuje generátor statické stránky od dokumentu?

Tři věci: Markdown pro tělo, YAML front matter pro metadata a obrázky jako soubory v relativních cestách. Hugo, Jekyll, MkDocs a Docusaurus všechny čtou front matter. convert_to_markdown vytváří všechno tři, když vyberete příslušné možnosti:

Možnost Hodnota pro stránku Co dělá
frontMatter true Zapíše YAML s názvem, autorem, formátem a počtem stránek na začátek souboru
images "file" Zapíše obrázky vedle souboru .md a odkazuje na ně pomocí relativní cesty
flavor "github" (výchozí), nebo "commonmark" GitHub‑flavoured Markdown je to, co většina generátorů předpokládá; CommonMark vyhovuje přísnějšímu nástroji

Zkontrolujte název a autora na začátku každého převedeného souboru; pokud jsou prázdné nebo nesprávné, požádejte agenta, aby je nastavil.

Jak převést Word do Hugo Markdownu?

Hugo je generátor za tímto blogem, takže je zde příkladem. Průběh má čtyři kroky a agent je všechny provede.

  1. Převod. Spusťte výše uvedený prompt na složce s dokumenty.
  2. Uspořádání. Server zapisuje soubory; rozvržení je úkolem agenta.

    Umístěte každý převedený soubor do složky pojmenované podle dokumentu, s jeho obrázky v podadresáři images vedle něj.

  3. Přidejte klíče, které téma požaduje. Témata Hugo často očekávají date nebo weight. Nástroj je nezapisuje, takže se zeptejte:

    Přidejte weight do front matter každého souboru, očíslované v pořadí, ve kterém jsem je vyjmenoval.

  4. Sestavení. Spusťte Hugo sami. V tomto okamžiku jsou soubory obyčejným Markdownem s front matter a generátor je zpracuje jako jakoukoli stránku.

Pro Docusaurus a MkDocs platí stejný výstup; liší se pouze rozvržení složek a další klíče, které popíšete ve druhém a třetím promptu.

Příklad relace (zkrácený)

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.

Jak zkontrolovat výsledek před publikací?

Dvě kontroly zachytí téměř každý problém:

Pro každý převedený soubor porovnejte počet stránek zdroje s délkou Markdownu.

60stránkový dokument, který se změnil na 3 KB Markdownu, je naskenovaný PDF nebo běh v režimu hodnocení.

Vylistujte složku s obrázky každého dokumentu a obrázky, na které odkazuje jeho Markdown.

.md, který odkazuje na obrázky, které nebyly nikdy zapsány, se na stránce zobrazí jako poškozené obrázky. Proveďte náhodnou kontrolu nejnepořádanějšího zdroje před dávkou dvou set.

Zdrojové soubory Word a Excel se převádějí se zachovanou strukturou: nadpisy zůstávají nadpisy a tabulky se mění na Markdown tabulky. PDF závisí na tom, jak byly vytvořeny. Digitální export se převádí čistě; sken se nepřevádí smysluplně, protože tento server nemá krok OCR.

Které klíče front matter přidávám sám?

frontMatter: true zapisuje název, autora, formát a počet stránek. Zkontrolujte tyto hodnoty v každém souboru a požádejte agenta, aby opravil ty, které jsou prázdné nebo nesprávné. Navigace, řazení, štítky a data jsou klíče, které přidáte po konverzi, jako v kroku 3. Pro získání bohatějších vlastností dokumentu do front matter spojte tento server s GroupDocs.Metadata.Mcp, který je čte, a nechte agenta přidat klíče; tento příspěvek to nepokrývá.

Upřímná omezení

Bez licence server běží v režimu hodnocení a zpracuje pouze první 3 stránky, přičemž na každé je umístěna vodotisková značka hodnocení. Stránka vytvořená z nelicencovaného výstupu obsahuje třístránkové úryvky dlouhých dokumentů. Před konverzí spusťte get_license_status a udržujte kontrolu „délka oproti zdroji“ v cyklu.

Často kladené otázky

Jak převést Word do Hugo Markdownu?

Požádejte agenta, aby převzal dokument s frontMatter: true, images: "file" a flavor: "github", a poté uspořádal soubory ve vaší složce obsahu. Přidejte jakékoli klíče specifické pro téma, například weight, ve druhém promptu.

Může AI agent publikovat dokumenty na statickou stránku?

Může připravit vše, co je potřeba pro sestavení stránky: Markdown, front matter, soubory s obrázky a rozvržení složek. Vy spustíte generátor, takže sestavení a nasazení zůstávají pod vaší kontrolou.

Probíhá konverze lokálně?

Ano. GroupDocs.Markdown.Mcp běží jako lokální proces přes stdio a čte dokumenty ze složky, kterou jste nakonfigurovali. Dokumenty, které se stanou veřejnými až po revizi, zůstávají na vašem počítači, dokud je nepublikujete.

Prohloubení