Statik bir site olarak belgeleri yayınlamak için, bir AI ajanına bunları YAML ön bilgili Markdown’a ve resimleri dosya olarak kaydedilecek şekilde dönüştürmesini söyleyin, ardından jeneratörünüzü çalıştırın. GroupDocs.Markdown.Mcp dönüşümü yerel olarak yapar, bu yüzden Claude Desktop, Claude Code, Cursor veya GitHub Copilot, Word, Excel ve e‑kitap içeriğini Hugo, Jekyll, MkDocs veya Docusaurus için bir hizmete göndermeden hazırlayabilir:

Bu belgeleri ön bilgiyle, GitHub lezzetiyle ve resimler dosya olarak kaydedilecek şekilde Markdown’a dönüştür.

Yapılandırma ve sorun giderme adımlarıyla birlikte adım adım sürüm belgelerde bulunabilir: Statik bir siteye Markdown olarak belgeleri nasıl yayınlarsınız.

Bir statik site jeneratörünün bir belgeden neye ihtiyacı var?

Üç şey: gövde için Markdown, meta veri için YAML ön bilgi ve göreli yollarla dosya olarak resimler. Hugo, Jekyll, MkDocs ve Docusaurus hepsi ön bilgiyi okur. convert_to_markdown bu üçünü de, seçenekleri seçtiğinizde üretir:

Seçenek Site için değer Ne yapar
frontMatter true YAML’yi dosyanın üst kısmına başlık, yazar, format ve sayfa sayısı ile yazar
images "file" Resimleri .md dosyasının yanına yazar ve göreli yol ile referans verir
flavor "github" (default), or "commonmark" GitHub lezzetli Markdown, çoğu jeneratörün varsaydığı şeydir; CommonMark daha katı bir araç zincirine uygundur

Her dönüştürülmüş dosyanın üst kısmındaki başlık ve yazarını kontrol edin; eğer boş ya da yanlışlarsa, ajanı bunları ayarlamasını isteyin.

Word’ü Hugo Markdown’a nasıl dönüştürürüm?

Hugo, bu blogun arkasındaki jeneratördür, bu yüzden burada örnek olarak kullanılıyor. İş akışı dört adımdan oluşur ve ajan hepsini yürütür.

  1. Dönüştür. Yukarıdaki istemi belge klasöründe çalıştırın.
  2. Düzenle. Sunucu dosyaları yazar; düzenleme ajanının işidir.

    Her dönüştürülmüş dosyayı belge adını taşıyan bir klasöre koyun, resimlerini ise yanındaki bir images alt klasörüne yerleştirin.

  3. Temanın istediği anahtarları ekle. Hugo temaları genellikle date veya weight bekler. Araç bunları yazmaz, bu yüzden isteyin:

    Her dosyanın ön bilgisine weight ekleyin, listelediğim sıraya göre numaralandırılmış.

  4. Derle. Hugo’yu kendiniz çalıştırın. Bu noktada dosyalar ön bilgiye sahip sıradan Markdown’dur ve jeneratör onları herhangi bir sayfa gibi işler.

Docusaurus ve MkDocs için aynı çıktı geçerlidir; sadece klasör düzeni ve ekstra anahtarlar farklıdır ve bunları ikinci ve üçüncü istemlerde tanımlarsınız.

Örnek oturum (kısaltılmış)

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.

Yayınlamadan önce sonucu nasıl kontrol ederim?

İki kontrol neredeyse tüm sorunları yakalar:

Her dönüştürülmüş dosya için, kaynağın sayfa sayısını Markdown uzunluğuyla karşılaştırın.

60 sayfalık bir belgenin 3 KB Markdown’a dönüşmesi, taranmış bir PDF ya da değerlendirme modunda çalıştırılmış bir belgedir.

Her belgenin resim klasörünü ve Markdown’un referans verdiği resimleri listeleyin.

Yazılmamış resimlere referans veren bir .md, sitede kırık resimler olarak görünür. İki yüzlük bir toplu işlemden önce en karışık kaynağı gözden geçirin.

Word ve Excel kaynakları yapılarını koruyarak dönüştürülür: başlıklar başlık olur ve tablolar Markdown tablolarına dönüşür. PDF’ler üretim şekline bağlıdır. Dijital olarak oluşturulmuş bir dışa aktarım temiz bir şekilde dönüştürülür; bir tarama ise bu sunucunun OCR adımı olmadığı için hiçbir anlamlı şekilde dönüştürülemez.

Hangi ön bilgi anahtarlarını kendim eklerim?

frontMatter: true başlık, yazar, format ve sayfa sayısını yazar. Bu değerleri her dosyada kontrol edin ve ajanı boş ya da yanlış olanları düzeltmesini isteyin. Navigasyon, sıralama, etiketler ve tarihler, dönüşümden sonra eklediğiniz anahtarlardır, adım 3’teki gibi. Daha zengin belge özelliklerini ön bilgiye eklemek için bu sunucuyu GroupDocs.Metadata.Mcp ile eşleştirin; bu sunucu onları okur ve ajanı anahtarları eklemeye yönlendirin; bu gönderi bunu kapsamaz.

Dürüst sınırlamalar

Lisans olmadan sunucu değerlendirme modunda çalışır ve yalnızca ilk 3 sayfa işlenir, her birine bir değerlendirme filigranı eklenir. Lisanssız çıktıyla oluşturulan bir site, uzun belgelerin üç sayfalık özetlerini gönderir. Dönüştürmeden önce get_license_status komutunu çalıştırın ve “kaynağa karşı uzunluk” kontrolünü döngüde tutun.

SSS

Word’ü Hugo Markdown’a nasıl dönüştürürüm?

Ajanı belgeyi frontMatter: true, images: "file" ve flavor: "github" ile dönüştürmesini, ardından dosyaları içerik klasörünüzde düzenlemesini isteyin. weight gibi tema‑özel anahtarları ikinci bir istemde ekleyin.

Bir AI ajanı belgeleri statik bir siteye yayınlayabilir mi?

Site derlemesinin ihtiyaç duyduğu her şeyi hazırlayabilir: Markdown, ön bilgi, resim dosyaları ve klasör düzeni. Jeneratörü siz çalıştırırsınız, bu yüzden derleme ve dağıtım kontrolünüz altında kalır.

Dönüşüm yerel olarak gerçekleşiyor mu?

Evet. GroupDocs.Markdown.Mcp stdio üzerinden yerel bir süreç olarak çalışır ve belgeleri yapılandırdığınız klasörden okur. Yalnızca incelemeden sonra halka açık hale gelen belgeler, siz yayınlayana kadar makinenizde kalır.

Daha derine inin