You can turn a PDF into LLM-ready Markdown by uploading it to a service, by pasting its text into a chat, or by asking your agent to call a conversion engine on your own machine. The third route keeps headings, tables and lists as real Markdown and uploads nothing. With the GroupDocs.Conversion.Mcp server, Claude, Cursor or GitHub Copilot run it locally from one prompt:

Convert report.pdf to Markdown

The step-by-step version with config and troubleshooting is in the documentation: How to convert PDF to Markdown with an MCP server.

Markdown 단계가 RAG 인덱스 품질을 결정하는 이유는?

검색 파이프라인은 변환 단계에서 남겨진 내용만 인덱싱할 수 있습니다. 표가 숫자 나열로 평탄화되면, 그 표의 일부는 어떤 질문에도 답하지 못합니다. 헤딩이 사라지면, 청크러가 구역 경계를 인식할 수 없습니다. 개인 지식 베이스에 가장 넣고 싶은 문서는 종종 제3자에게 보내고 싶지 않은 문서—계약서, 내부 보고서, 환자 또는 고객 기록—입니다. 따라서 경로 선택은 한 번에 두 가지를 결정합니다: 얼마나 많은 구조가 살아남는가, 그리고 파일이 어디로 이동하는가.

방법 1: PDF를 온라인 변환기 또는 클라우드 파싱 API에 업로드하시겠습니까?

가장 빠른 경로이며, 가장 큰 트레이드오프가 있는 방법입니다. 파일이 사용자가 제어하지 않는 인프라로 이동해 처리됩니다. 공개 문서라면 허용될 수 있지만, 기밀 문서는 보안 검토에서 차단되는 단계입니다.

내용이 민감하지 않고 다른 사람의 서비스로 파일이 한 번 왕복하는 것을 허용할 때만 선택하십시오.

방법 2: PDF 텍스트를 채팅에 붙여넣고 모델에게 포맷을 요청하시겠습니까?

프로세스가 사용자의 테이블 쪽에 남지만, 이제 모델은 내용을 변환하는 것이 아니라 재작성합니다. 붙여넣은 텍스트만 모델이 보게 되며, 표 경계, 열 순서 및 페이지 레이아웃은 이미 사라졌고, 모델은 추측으로 빈틈을 메웁니다. 긴 문서는 마지막 페이지에 도달하기 전에 컨텍스트 창을 초과합니다.

한 번의 문단 변환에만 사용하고, 보고서 폴더 전체에는 사용하지 마십시오.

방법 3: 에이전트가 로컬 변환 엔진을 호출하도록 하시겠습니까?

여기서는 에이전트가 결정하고 엔진이 변환합니다. 에이전트는 파일 이름과 목표 포맷을 convert 도구에 전달하고, GroupDocs.Conversion 엔진은 문서 옆에 Markdown 파일을 작성합니다. 도구 호출에서 포맷은 md입니다:

{
  "name": "convert",
  "arguments": {
    "file": { "filePath": "report.pdf" },
    "format": "md"
  }
}

이 JSON을 직접 작성하지 않습니다. 문장을 입력하면 에이전트가 호출을 생성합니다. 구조는 실제 Markdown 구문으로 보존됩니다: 헤딩은 # 및 ##가 되고, 표는 파이프 테이블, 리스트는 리스트 아이템이 됩니다. 이는 임베딩 파이프라인과 LLM이 네이티브로 읽을 수 있는 형식이며, 파일을 바로 청크러에 전달할 수 있습니다.

결과 형태는 다음과 같습니다. 아래 내용은 예시이며 실제 실행 결과는 아닙니다:

# Quarterly report

## Revenue by region

| Region | Q1 | Q2 |
|---|---|---|
| North | 120 | 135 |
| South | 98 | 101 |

복잡한 레이아웃은 문서 충실도를 위해 설계된 엔진이 기본 텍스트 추출기와 차별화되는 부분입니다. 문서에 중요한지 여부는 가장 어려운 PDF 세 개에 대해 테스트해 보세요.

Markdown만 필요하다면 GroupDocs에도 전용 서버인 GroupDocs.Markdown.Mcp가 있습니다. 해당 문서는 PDF, Word, Excel, EPUB 및 20개 이상의 포맷을 깔끔하고 구조화된 Markdown으로 변환하며, 페이지 선택, 이미지 및 프런트 매터를 제어할 수 있다고 설명합니다. GroupDocs.Conversion.Mcp는 동일 워크플로우에서 Markdown이 여러 대상 포맷 중 하나일 때 적합합니다. RAG 중심 비교는 Your RAG pipeline starts with Markdown — keep that step local에 있으며, 서버 문서는 docs.groupdocs.com/markdown/mcp에 있습니다.

로컬 경로를 어떻게 설정합니까?

클라이언트에 서버를 한 번만 등록합니다. Claude Desktop 예시:

{
  "mcpServers": {
    "groupdocs-conversion": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Conversion.Mcp", "--yes"],
      "env": { "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents" }
    }
  }
}

이 설정은 .NET 10 SDK가 필요합니다. 동일한 서버 항목은 Cursor, VS Code with GitHub Copilot, Claude Code에서도 작동하며, 각 클라이언트에 대한 정확한 구성 파일은 docs hub에 나와 있습니다. 클라이언트를 재시작하십시오. 평가 모드 또는 라이선스 파일 모드에서는 패키지를 다운로드한 뒤 네트워크가 필요 없으며, 사용량을 보고하는 계량 라이선스는 외부 접근이 필요합니다.

작동하는 프롬프트 예시:

Turn every PDF in this folder into Markdown for my knowledge base.

Check how many pages whitepaper.pdf has, then convert it to Markdown.

두 번째 프롬프트는 get_document_info를 호출해 파일 유형, 페이지 수 및 기본 속성을 반환한 뒤 convert를 실행합니다.

예시 세션

다음은 문서에 설명된 도구 동작을 기반으로 만든 축약된 예시이며, 실제 스크린샷이 아닙니다.

You:    Check how many pages whitepaper.pdf has, then convert it to Markdown.
Agent:  [calls get_document_info with file.filePath = "whitepaper.pdf"]
Agent:  [calls convert with file.filePath = "whitepaper.pdf", format = "md"]
Agent:  Done. The Markdown file is saved as whitepaper.md in your output folder.

제한 사항은 무엇입니까?

  • Scans need OCR first. 이미지 전용 PDF는 텍스트 레이어가 없으며 OCR은 이 서버에 포함되지 않으므로 Markdown에 단어가 포함되지 않습니다. PDF가 스캔본이라면 변환 전에 OCR을 수행하십시오.
  • Evaluation mode. 라이선스가 없으면 출력에 평가 워터마크가 삽입되고, 하나의 서버 프로세스가 동시에 열 수 있는 문서는 최대 15개입니다. 대량 수집 전에 get_license_status를 호출해 현재 모드를 확인하십시오.
  • Conversion, not extraction. 이 서버는 전체 문서를 Markdown으로 변환합니다. 특정 필드나 값만 추출해야 한다면 GroupDocs.Parser.Mcp (Docker 이미지 전용)를 사용하고, 파이프라인에 두 서버를 모두 연결하십시오.

FAQ

How do I convert PDF to Markdown for RAG without uploading the file?
자신의 머신에서 변환 서버를 실행하고 에이전트가 호출하도록 하십시오. GroupDocs.Conversion.Mcp를 사용하면 convert 도구가 .md 파일을 폴더에 저장하고, 문서는 클라우드 서비스로 전송되지 않습니다.

Are tables kept when a PDF becomes Markdown?
예, Markdown 파이프 테이블 형태로 보존됩니다. 레이아웃 복잡도가 변환기마다 차이가 나는 부분이므로 가장 복잡한 표부터 테스트하십시오.

Can I convert the Markdown back to PDF or Word later?
예. 동일 서버가 Markdown을 PDF와 DOCX로 변환할 수 있으며, 자세한 내용은 the export post에 있습니다.

더 깊이 파고들기