要將文件發布為靜態網站，請讓 AI 代理將它們轉換為帶有 YAML 前置資料且圖像保存為檔案的 Markdown，然後執行您的生成器。GroupDocs.Markdown.Mcp 在本地執行轉換，因此 Claude Desktop、Claude Code、Cursor 或 GitHub Copilot 可以為 Hugo、Jekyll、MkDocs 或 Docusaurus 準備 Word、Excel 和電子書內容，而無需將其發送到服務：
將這些文件轉換為帶有前置資料、GitHub 風格且圖像保存為檔案的 Markdown。
包含配置和故障排除的逐步說明位於文件中： 如何將文件發布為靜態網站的 Markdown.
靜態網站生成器需要從文件中獲得什麼？
三件事：正文的 Markdown、元資料的 YAML 前置資料，以及相對路徑的圖像檔案。Hugo、Jekyll、MkDocs 和 Docusaurus 都會讀取前置資料。convert_to_markdown 在您選擇相應選項時會產生這三項：
| 選項 | 網站的值 | 功能說明 |
|---|---|---|
frontMatter |
true |
在檔案頂部寫入包含標題、作者、格式和頁數的 YAML |
images |
"file" |
將圖片寫入 .md 同目錄旁，並以相對路徑引用它們 |
flavor |
"github" (default), or "commonmark" |
GitHub 風格的 Markdown 是大多數生成器的預設；CommonMark 適用於更嚴格的工具鏈 |
檢查每個轉換後檔案頂部的標題和作者；如果它們為空或不正確，請讓代理設定它們。
如何將 Word 轉換為 Hugo Markdown？
Hugo 是本部落格背後的生成器，因此此處以它為範例。整個流程有四個步驟，代理會執行全部。
- 轉換。 在文件資料夾上執行上述提示。
- 整理。 伺服器寫入檔案；版面配置由代理負責。
將每個轉換後的檔案放入以文件名稱命名的資料夾中，並將其圖像放在同旁的
images子資料夾中。 - 加入主題需要的鍵。 Hugo 主題通常需要
date或weight。工具不會寫入它們，因此請求：將
weight加入每個檔案的前置資料，依我列出的順序編號。 - 建置。 自行執行 Hugo。此時檔案是普通的帶前置資料的 Markdown，生成器會將它們視為任何頁面。
對於 Docusaurus 和 MkDocs，輸出相同；唯一差異在於資料夾布局和額外鍵，您可在第二與第三個提示中說明它們。
範例會話（節錄）
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.
如何在發布前檢查結果？
兩項檢查可捕捉幾乎所有問題：
對每個轉換後的檔案，將來源的頁數與 Markdown 的長度進行比較。
一份 60 頁的文件卻只產生 3 KB 的 Markdown，表示它是掃描的 PDF 或以評估模式執行的結果。
列出每個文件的圖像資料夾以及其 Markdown 所引用的圖像。
若 .md 引用了從未寫入的圖片，網站上會顯示破圖。請在一次處理兩百份之前，抽樣檢查最混亂的來源。
Word 和 Excel 來源會保留其結構轉換：標題仍為標題，表格會變為 Markdown 表格。PDF 的轉換取決於其產生方式。原生數位匯出可乾淨轉換；掃描件則無法以任何有用方式轉換，因為此伺服器沒有 OCR 步驟。
哪些前置資料鍵需要自行加入？
frontMatter: true 會寫入標題、作者、格式與頁數。檢查每個檔案中的這些值，並請代理更正任何空白或錯誤的項目。導航、排序、標籤與日期是您在轉換後（如第 3 步）加入的鍵。若要將更豐富的文件屬性拉入前置資料，可將此伺服器與 GroupDocs.Metadata.Mcp 結合，該工具會讀取屬性，然後讓代理加入鍵；本文不涵蓋此部分。
誠實的限制
若未取得授權，伺服器會以評估模式運行，僅處理前 3 頁，且每頁都有評估水印。使用未授權的輸出建置的網站只會顯示長文件的三頁摘要。請在轉換前執行 get_license_status，並持續進行「長度與來源」檢查。
常見問題
如何將 Word 轉換為 Hugo Markdown？
請讓代理使用 frontMatter: true、images: "file" 與 flavor: "github" 轉換文件，然後將檔案整理至您的 content 資料夾。於第二個提示中加入任何主題特定的鍵，例如 weight。
AI 代理能將文件發布到靜態網站嗎？
它可以準備網站建置所需的全部內容：Markdown、前置資料、圖像檔案與資料夾布局。您自行執行生成器，建置與部署仍由您掌控。
轉換是否在本地執行？
是的。GroupDocs.Markdown.Mcp 以本地進程透過 stdio 執行，並從您設定的資料夾讀取文件。只有在審核後才公開的文件會一直保留在您的機器上，直至您發布它們。
深入了解
- 文件說明，標準操作指南： 如何將文件發布為靜態網站的 Markdown
- 文件中心： GroupDocs.Markdown MCP Server
- 從此開始： 您的 RAG 流程從 Markdown 開始 — 保持此步驟在本地
- 相關： 使用 MCP 將所需段落提取為 Markdown 的 3 種方法
- 相關： 自動化 docs-as-code 移轉：代理執行轉換，您負責審核
- 本地部署與安全模型： AI 文件處理的 3 種架構，以及將檔案保留在您網路內的方案
- 問題討論： GroupDocs Markdown 論壇
- 原始碼： GroupDocs.Markdown.Mcp 在 GitHub