静的サイトとしてドキュメントを公開するには、AI エージェントにそれらを YAML フロントマター付きの Markdown に変換し、画像をファイルとして保存させてから、ジェネレーターを実行させます。GroupDocs.Markdown.Mcp はローカルで変換を行うため、Claude Desktop、Claude Code、Cursor、または GitHub Copilot が Word、Excel、電子書籍コンテンツを Hugo、Jekyll、MkDocs、Docusaurus 用に準備でき、サービスに送信する必要はありません。
これらのドキュメントをフロントマター、GitHub フレーバー、画像をファイルとして保存した Markdown に変換してください。
設定とトラブルシューティングを含むステップバイステップのバージョンはドキュメントにあります: How to publish documents to a static site as Markdown.
静的サイトジェネレーターがドキュメントから必要とするものは何ですか？
3 つの要素があります：本文の 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 はこのブログのジェネレーターなので、ここでは例として使用します。フローは 4 つのステップからなり、エージェントがすべて実行します。
- 変換。 上記のプロンプトをドキュメントのフォルダーに対して実行します。
- 配置。 サーバーがファイルを書き込みます；レイアウトはエージェントの仕事です。
各変換ファイルをドキュメント名のフォルダーに入れ、画像はその隣に
imagesサブフォルダーとして配置してください。 - テーマが必要とするキーを追加。 Hugo テーマはしばしば
dateやweightを期待します。ツールはそれらを書き込まないので、次のように依頼してください：weightを各ファイルのフロントマターに追加し、リストした順序で番号付けしてください。 - ビルド。 自分で Hugo を実行します。この時点でファイルはフロントマター付きの普通の Markdown であり、ジェネレーターはそれらを通常のページとして扱います。
Docusaurus と MkDocs でも同じ出力が適用されます；フォルダー構成と追加キーが異なるだけで、これらは 2 番目と 3 番目のプロンプトで説明します。
例のセッション（抜粋）
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.
公開前に結果を確認するには？
2 つのチェックでほぼすべての問題を捕捉できます：
各変換ファイルについて、元のページ数と Markdown の長さを比較してください。
60 ページのドキュメントが 3 KB の Markdown になっている場合、それはスキャンされた PDF か評価モードでの実行です。
各ドキュメントの画像フォルダーと、Markdown が参照している画像を一覧にしてください。
画像が書き込まれていない .md が画像を参照していると、サイト上で壊れた画像として表示されます。200 件のバッチを処理する前に、最も乱雑なソースを抜き打ちで確認してください。
Word と Excel のソースは構造を保ったまま変換されます：見出しは見出しに、表は Markdown の表に変換されます。PDF は作成方法に依存します。デジタルで作成されたエクスポートはきれいに変換されますが、スキャンは有用な形で変換されません。なぜならこのサーバーには OCR ステップがないからです。
フロントマターのキーは自分でどれを追加すべきか？
frontMatter: true はタイトル、著者、フォーマット、ページ数を書き込みます。各ファイルでそれらの値を確認し、空欄または誤っているものはエージェントに修正させてください。ナビゲーション、順序付け、タグ、日付は変換後に追加するキーで、ステップ 3 のように行います。フロントマターによりリッチなドキュメントプロパティを取り込むには、このサーバーを GroupDocs.Metadata.Mcp と組み合わせて使用し、エージェントにキーを追加させます；この投稿ではそれについては扱いません。
正直な制限
ライセンスがない場合、サーバーは評価モードで動作し、最初の 3 ページのみが処理され、各ページに評価用の透かしが付加されます。未ライセンスの出力から構築されたサイトは、長いドキュメントの 3 ページ分のスタブしか提供しません。変換前に get_license_status を実行し、“length against source”（ソースに対する長さ）チェックをループに入れ続けてください。
FAQ
Word を Hugo 用 Markdown に変換するには？
エージェントに frontMatter: true、images: "file"、flavor: "github" でドキュメントを変換させ、その後ファイルをコンテンツフォルダーに配置するよう依頼してください。weight のようなテーマ固有のキーは、2 回目のプロンプトで追加します。
AI エージェントがドキュメントを静的サイトに公開できるか？
サイトのビルドに必要なすべて、Markdown、フロントマター、画像ファイル、フォルダー構成を準備できます。ジェネレーターは自分で実行するので、ビルドとデプロイは自分の管理下に置かれます。
変換はローカルで行われますか？
はい。GroupDocs.Markdown.Mcp は stdio 経由でローカルプロセスとして実行され、設定したフォルダーからドキュメントを読み取ります。レビュー後に公開されるドキュメントは、公開するまでマシン上に残ります。
さらに深掘り
- ドキュメント、標準的な手順: How to publish documents to a static site as Markdown
- ドキュメントハブ: GroupDocs.Markdown MCP Server
- ここから始める: Your RAG pipeline starts with Markdown — keep that step local
- 関連: 3 ways to pull just the section you need into Markdown with MCP
- 関連: Automate a docs-as-code migration: the agent runs the conversion, you review
- オンプレミスとセキュリティモデル: 3 architectures for AI document processing, and the one that keeps files inside your network
- 質問: GroupDocs Markdown forum
- ソース: GroupDocs.Markdown.Mcp on GitHub