當文件對於上下文視窗過大時，只轉換您需要的部分。GroupDocs.Markdown.Mcp 允許 AI 代理在本機將選取的頁面或工作表轉換為 Markdown，支援 Claude Desktop、Claude Code、Cursor 或 GitHub Copilot，讓大型語言模型只閱讀單一章節而非整本書：

Convert pages 40 to 52 of handbook.pdf to Markdown.

包含設定與故障排除的逐步說明位於文件中：How to convert just one section of a document to Markdown。

範圍轉換能節省什麼？

您在提示中輸入的每個字都會被模型提供者閱讀、計費，且會與其他所有字競爭注意力。對於長文件的大多數問題只涉及其中的一小部分。先將全部內容轉換，再請模型忽略大部分內容，等於在每個問題上都為整份文件付費。

在您自己的文件上可以輕鬆測量節省的效果。以下是一個真實測量範例，並說明其方法。該檔案是本伺服器文件中授權頁面的 Markdown 原始碼。我們在 front matter 之後將其分割，統計以空白分隔的單詞、程式碼區塊以及 Hugo 短代碼標記（整頁在不計算短代碼時為 810 個單詞）。下表說明了某段落與整頁之間的比例；它並非 pages 參數的測量結果，pages 會選取頁面而非標題：

頁面段落 字數
簡介與三種授權模式 167
評估模式限制 93
套用授權 78
計量式（按使用付費）授權 366
確認目前啟用的模式 113
取得授權 27
整頁 844

關於哪種授權模式正在啟用的問題只需要 113 個字的段落。這大約佔頁面的 13%，或是整頁的約 7.5 倍短。此計數以字數表示，因為 token 取決於模型的分詞器；token 數量會隨字數變化，我們未在此提供未測量的 token 數字。此頁特意寫得較短。您的手冊會更大，比例則需自行計算。

方法 1：我可以直接指定哪些頁面？

如果您知道頁碼，直接說明即可。convert_to_markdown 的 pages 參數接受以逗號分隔的 1 起始數字列表，例如 "40,41,42"。參數中沒有範圍語法；代理會將「40 to 52」展開為列表。若省略 pages，則會轉換整份文件。

Convert pages 40 to 52 of handbook.pdf to Markdown.

結果會產生一個已儲存的 .md 檔案，且內容會內嵌返回。較長的輸出會在內嵌顯示時被截斷，完整文字則保存在儲存的檔案中。

方法 2：如何僅轉換第 3 章？

此工具沒有標題範圍的選項，因此「第 3 章」必須先轉換為頁碼。可分兩個小步驟完成：

How many pages does handbook.pdf have, and what is its title?

get_document_info 會直接從檔案回傳資訊，無需轉換：pageCount、title、author、fileFormat 與 isEncrypted。它也會提前告知是否需要密碼。接著，轉換目錄頁面，閱讀後再請求它們所指的範圍。

範例對話（節錄）：

You:   How many pages does handbook.pdf have, and what is its title?
Agent: get_document_info -> pageCount: 212, title: "Operations Handbook".
You:   Convert pages 3 to 4 (the table of contents), then convert chapter 3.
Agent: convert_to_markdown (pages: "3,4") -> contents read: chapter 3 runs pages 61 to 64.
       convert_to_markdown (pages: "61,62,63,64") -> saved chapter 3 as Markdown.

兩個小轉換取代一次巨大的轉換。

方法 3：如何從活頁簿中取得單一工作表？

在 XLSX、XLS 與 ODS 檔案中，數字代表選取工作表，而非列印頁面：

Convert worksheet 2 of the model to Markdown.

這會將單一表格放入文件中，而不包含同一活頁簿內的其他工作表。

何時範圍轉換值得額外的步驟？

  • 上下文。 LLM 只收到能回答問題的那部分內容，長文件則保持在視窗內。
  • 計量成本。 在計量授權下，您只為處理的內容付費，因此頁數越少，帳單越低。
  • 檢索品質。 索引僅包含相關的附錄，不會在每次查詢時被其餘舊有資料稀釋。

如果整份文件都是工作內容，則不需要範圍化。一次轉換即可，並保留 Markdown。

誠實的限制：評估模式下的頁數

未取得授權時，伺服器會以評估模式運行：僅處理前 3 頁，且每頁都有評估水印。此設定會覆寫 pages。在評估模式下請求第 40 至 52 頁會回傳第 1 至 3 頁且不會產生錯誤，因此無授權時無法測試書中間的章節。若輸出未從預期位置開始，請先呼叫 get_license_status。

目錄可以使用列印的頁碼標籤。若轉換的頁面未從預期的標題開始，可請求代理轉換相鄰頁面並調整列表；get_document_info 會提供總頁數，以限制列表範圍。

常見問題

如何僅將第 3 章轉換為 Markdown？

先找出該章的頁碼，然後在 pages 中傳入。請求代理轉換目錄頁面，閱讀後再請求它們所提供的範圍。

當文件對於上下文視窗過大時該怎麼辦？

只轉換文件的一部分，而非全部。使用 pages 選取能回答您問題的頁面或工作表，並在開始前使用 get_document_info 檢查頁數。

我可以使用 AI 將 PDF 第 10 至 20 頁轉換為 Markdown 嗎？

可以。以自然語言提出，例如「Convert pages 10 to 20 of report.pdf to Markdown」，代理會傳送展開後的頁碼列表。未授權時，僅會處理前 3 頁。

深入了解