Aby opublikować dokumenty jako statyczną witrynę, poproś agenta AI o konwersję ich do Markdown z metadanymi YAML i obrazami zapisanymi jako pliki, a następnie uruchom swój generator. GroupDocs.Markdown.Mcp wykonuje konwersję lokalnie, więc Claude Desktop, Claude Code, Cursor lub GitHub Copilot mogą przygotować treść Word, Excel i e‑booków dla Hugo, Jekyll, MkDocs lub Docusaurus bez wysyłania jej do usługi:

Przekonwertuj te dokumenty do Markdown z metadanymi, w stylu GitHub i obrazami zapisanymi jako pliki.

Wersja krok po kroku z konfiguracją i rozwiązywaniem problemów znajduje się w dokumentacji: Jak opublikować dokumenty jako statyczną witrynę w formacie Markdown.

Czego potrzebuje generator statycznej witryny od dokumentu?

Trzy rzeczy: Markdown dla treści, metadane YAML dla danych opisowych oraz obrazy jako pliki w ścieżkach względnych. Hugo, Jekyll, MkDocs i Docusaurus wszystkie odczytują metadane. convert_to_markdown generuje wszystkie trzy, gdy wybierzesz odpowiednie opcje:

Opcja Wartość dla witryny Co robi
frontMatter true Zapisuje YAML z tytułem, autorem, formatem i liczbą stron na początku pliku
images "file" Zapisuje obrazy obok pliku .md i odwołuje się do nich za pomocą ścieżki względnej
flavor "github" (default), or "commonmark" Markdown w stylu GitHub jest tym, czego zakłada większość generatorów; CommonMark pasuje do bardziej rygorystycznego łańcucha narzędzi

Sprawdź tytuł i autora na początku każdego przekonwertowanego pliku; jeśli są puste lub nieprawidłowe, poproś agenta o ich ustawienie.

Jak przekonwertować Word do Markdown dla Hugo?

Hugo jest generatorem stojącym za tym blogiem, więc jest tutaj przykładem. Proces składa się z czterech kroków, a agent wykonuje je wszystkie.

  1. Convert. Uruchom powyższy prompt w folderze z dokumentami.
  2. Arrange. Serwer zapisuje pliki; układ to zadanie agenta.

    Umieść każdy przekonwertowany plik w folderze nazwanym po dokumencie, a jego obrazy w podfolderze images obok niego.

  3. Add the keys the theme wants. Motywy Hugo często oczekują date lub weight. Narzędzie ich nie zapisuje, więc poproś:

    Dodaj weight do metadanych każdego pliku, ponumerowane w kolejności, w której je wymieniłem.

  4. Build. Uruchom Hugo samodzielnie. W tym momencie pliki są zwykłym Markdown z metadanymi, a generator traktuje je jak każdą inną stronę.

Dla Docusaurus i MkDocs obowiązuje ten sam wynik; różni się jedynie układ folderów i dodatkowe klucze, które opisujesz w drugim i trzecim promptcie.

Przykładowa sesja (skrócona)

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 sprawdzić wynik przed publikacją?

Dwa sprawdzenia wykrywają prawie każdy problem:

Dla każdego przekonwertowanego pliku porównaj liczbę stron źródła z długością Markdown.

Dokument o 60 stronach, który zamienił się w 3 KB Markdown, to zeskanowany PDF lub uruchomienie w trybie ewaluacyjnym.

Wypisz folder obrazów każdego dokumentu oraz obrazy, do których odwołuje się jego Markdown.

Plik .md odwołujący się do nieistniejących obrazów wyświetli się jako zepsute obrazy na stronie. Przeprowadź kontrolę losową najtrudniejszego źródła przed batch’em dwustu dokumentów.

Źródła Word i Excel konwertują się zachowując strukturę: nagłówki pozostają nagłówkami, a tabele stają się tabelami Markdown. PDF-y zależą od sposobu ich stworzenia. Eksport w formacie cyfrowym konwertuje się czysto; skan nie konwertuje w żaden użyteczny sposób, ponieważ ten serwer nie posiada kroku OCR.

Które klucze metadanych dodaję samodzielnie?

frontMatter: true zapisuje tytuł, autora, format i liczbę stron. Sprawdź te wartości w każdym pliku i poproś agenta o poprawienie tych, które są puste lub nieprawidłowe. Nawigacja, kolejność, tagi i daty to klucze, które dodajesz po konwersji, jak w kroku 3. Aby wprowadzić bogatsze właściwości dokumentu do metadanych, połącz ten serwer z GroupDocs.Metadata.Mcp, który je odczytuje, i poproś agenta o dodanie kluczy; ten wpis nie omawia tego.

Szczere ograniczenia

Bez licencji serwer działa w trybie ewaluacyjnym i przetwarza tylko pierwsze 3 strony, z nakładką ewaluacyjną na każdej. Witryna zbudowana z nielicencjonowanego wyniku zawiera trzystronne fragmenty długich dokumentów. Uruchom get_license_status przed konwersją i utrzymuj sprawdzenie „długość względem źródła” w pętli.

FAQ

Jak przekonwertować Word do Markdown dla Hugo?

Poproś agenta o konwersję dokumentu z frontMatter: true, images: "file" i flavor: "github", a następnie o ułożenie plików w folderze zawartości. Dodaj wszelkie klucze specyficzne dla motywu, takie jak weight, w drugim promptcie.

Czy agent AI może publikować dokumenty jako statyczną witrynę?

Może przygotować wszystko, czego potrzebuje budowa witryny: Markdown, metadane, pliki obrazów i układ folderów. Ty uruchamiasz generator, więc budowa i wdrożenie pozostają pod twoją kontrolą.

Czy konwersja odbywa się lokalnie?

Tak. GroupDocs.Markdown.Mcp działa jako lokalny proces korzystający ze stdio i odczytuje dokumenty z folderu, który skonfigurowałeś. Dokumenty, które stają się publiczne dopiero po przeglądzie, pozostają na twoim komputerze, dopóki ich nie opublikujesz.

Zagłęb się