When a document is too large for the context window, convert only the part you need. GroupDocs.Markdown.Mcp lets an AI agent turn selected pages or worksheets into Markdown locally, from Claude Desktop, Claude Code, Cursor or GitHub Copilot, so the LLM reads one chapter and not the whole book:

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

The step‑by‑step version with config and troubleshooting is in the documentation: 문서의 한 섹션만 Markdown으로 변환하는 방법.

범위 지정 변환으로 절감되는 비용은 무엇인가요?

프롬프트에 넣는 모든 단어는 모델 제공자가 읽고 청구하며, 다른 모든 단어와 주의를 경쟁합니다. 긴 문서에 대한 대부분의 질문은 그 중 작은 부분에 관한 것입니다. 모든 내용을 먼저 변환한 뒤 모델에게 대부분을 무시하도록 요청하면, 매 질문마다 전체 문서에 대한 비용을 지불하게 됩니다.

절감 효과는 자신이 보유한 문서에서 쉽게 측정할 수 있습니다. 아래는 실제 측정 예시와 방법을 명시한 것입니다. 파일은 이 서버 문서의 라이선스 페이지에 해당하는 Markdown 소스입니다. 프런트 매터 이후를 나누어 공백으로 구분된 단어, 코드 블록, Hugo shortcode 마크업을 포함해 단어 수를 셌습니다( shortcode를 제외하면 전체 페이지는 810단어). 표는 섹션과 페이지 전체 사이의 비율을 보여주며, pages 옵션이 페이지를 선택하고 헤딩을 선택하지 않기 때문에 측정된 결과는 아닙니다.

페이지 섹션 단어 수
소개 및 세 가지 라이선스 모드 167
평가 모드 제한 사항 93
라이선스 적용 78
계량형(사용량 기반) 라이선스 366
활성 모드 확인 113
라이선스 획득 27
전체 페이지 844

어떤 라이선스 모드가 활성화되어 있는지 묻는 질문은 113단어 섹션만 필요합니다. 이는 페이지 전체의 약 13 %에 해당하며, 전체보다 약 7.5배 짧습니다. 여기서는 단어 수를 사용했는데, 토큰 수는 모델 토크나이저에 따라 달라지므로 단어 수와 토큰 수는 비례합니다. 페이지는 의도적으로 짧게 만들었으며, 실제 매뉴얼은 더 클 것이고 비율은 직접 계산해 보세요.

방법 1: 직접 지정할 수 있는 페이지는?

페이지 번호를 알고 있다면 그대로 지정하면 됩니다. convert_to_markdown의 pages 매개변수는 "40,41,42"와 같이 쉼표로 구분된 1‑base 번호 목록을 받습니다. 범위 구문은 없으며, 에이전트가 "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 등을 반환합니다. 필요 시 비밀번호 여부도 미리 알려줍니다. 다음으로 목차 페이지를 변환하고, 그 안에서 챕터 3이 차지하는 페이지 범위를 확인합니다.

예시 세션 (요약):

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페이지만 처리됩니다.

더 깊이 파고들기