문서를 Markdown으로 마이그레이션하려면 AI 에이전트에게 아카이브 폴더를 제공하고 파일당 한 번씩 convert_to_markdown을 실행하도록 하며, 검토된 배치로 진행합니다. GroupDocs.Markdown.Mcp를 사용하면 Claude Code, Cursor, GitHub Copilot 또는 다른 MCP 클라이언트에서 로컬로 수행되므로 내부 절차의 아카이브가 변환 서비스에 업로드되지 않습니다:

아카이브 폴더의 모든 내용을 프런트 매터와 이미지 파일로 Markdown으로 변환하십시오. 각 파일에 대해 원본 형식, 페이지 수 및 출력 크기를 보고하십시오.

구성 및 문제 해결이 포함된 단계별 버전은 문서에 있습니다: How to migrate legacy documentation to Markdown with AI.

레거시 문서 마이그레이션이 에이전트 작업인 이유

변환은 기계적이며 주변 작업은 반복적입니다: 파일을 나열하고, 각각을 변환하고, 결과를 측정하고, 실패를 찾아내고, 반복합니다. 수백 개의 파일에 대해 이를 수행하는 사람은 같은 결정을 수백 번 내립니다. 에이전트는 이를 일관되게 수행하고 각 결과를 보고하며, 모델이 아니라 엔진이 Markdown을 생성합니다. 저장된 Markdown은 절차의 재진술이 아닙니다.

이는 런북입니다. 각 단계마다 하나의 프롬프트가 있으며, 그 뒤의 표는 에이전트가 결정하는 내용과 엔진이 수행하는 내용을 구분합니다.

런북: Word 아카이브를 Markdown으로 마이그레이션하려면 어떻게 해야 하나요?

  1. 다른 모든 작업보다 먼저 라이선스를 확인하십시오.

    변환하기 전에: markdown 서버의 라이선스 상태는 무엇입니까?

    get_license_status는 mode, licensed, consumption 및 서버와 엔진 버전을 반환합니다. 평가 모드는 문서당 3페이지만 처리하므로 라이선스가 없는 실행은 그럴듯한 스텁을 생성합니다.

  2. 아카이브를 인벤토리하십시오.

    아카이브 폴더에 있는 모든 파일을 형식, 페이지 수 및 암호화 여부와 함께 나열하십시오.

    Markdown 서버에는 폴더 목록 도구가 없으므로 에이전트는 클라이언트 자체 파일 접근을 사용하거나 제공된 파일 이름을 기반으로 폴더를 나열합니다.

    그런 다음 get_document_info는 변환 없이 각 파일에 대해 fileFormat, pageCount, title, author 및 isEncrypted를 반환합니다. 암호화된 파일은 password 매개변수가 필요합니다.

  3. 약 20개의 파일에 대해 파일럿을 실행하십시오.

    첫 번째 20개의 문서를 프런트 매터와 이미지 파일로 Markdown으로 변환하십시오. 각 파일에 대해 형식, 페이지 수 및 출력 크기를 보고하십시오.

  4. 변환되지 않은 항목을 찾으십시오.

    5페이지 이상에 대해 변환된 Markdown이 2KB 미만인 PDF를 나열하십시오.

    이는 거의 항상 스캔본입니다. 이 서버에는 OCR 단계가 없으므로 다른 도구가 필요하거나 메타데이터로 색인된 PDF로 유지됩니다.

  5. 패턴을 수정한 후 나머지를 배치로 실행하십시오. 한 라운드당 20개의 파일을 처리하고 매번 보고서를 제공하면 실행을 검토 가능하게 유지하고 사용량을 예측 가능하게 합니다.

  6. 출력을 풀 리퀘스트처럼 검토하십시오. 다음 섹션에서는 확인해야 할 항목을 나열합니다.

Decision Agent Engine
변환할 파일, 순서 및 배치 크기 예 아니오
전달할 옵션 (images, frontMatter, flavor) 예, 프롬프트에서 아니오
헤딩, 리스트 및 테이블을 Markdown으로 변환 아니오 예
.md 및 이미지 파일 저장 아니오 예
300페이지 파일이 4KB가 된 경우 탐지 예, 보고서에서 아니오
파일명 변경, 폴더 레이아웃, 추가 프런트 매터 키 예 아니오

어떤 형식이 잘 마이그레이션되나요?

  • DOCX, DOC, RTF, ODT. 소스에 구조가 명시되어 있어 헤딩과 테이블이 깔끔하게 전달됩니다.
  • EPUB 및 MOBI. 장 구조가 Markdown 헤딩에 매핑됩니다.
  • CHM. 오래된 도움말 파일로, 종종 절차의 유일한 사본입니다.
  • XLSX. 워크시트가 테이블이 되어 매개변수 목록에 적합합니다.

검토 단계에서 확인해야 할 사항은 무엇인가요?

에이전트에게 첫 번째 검사를 수행하도록 요청한 다음, 직접 샘플을 확인하십시오:

변환된 각 파일에 대해 참조하는 이미지를 나열하고 누락된 이미지 파일이 어떤 것인지 알려 주세요.

페이지 수 대비 가장 작은 크기의 다섯 개 출력물을 보여 주세요.

images: "file" 로 작성된 이미지는 .md 파일 옆에 위치하며 상대 경로로 참조됩니다. 이는 문서 저장소가 기대하는 방식입니다. 작성되지 않은 그림을 가리키는 .md는 깨진 이미지로 표시됩니다. 그런 다음 가장 복잡한 소스와 그 출력을 나란히 열어 패턴을 나머지에 적용하기 전에 확인하십시오. 검토된 결과를 일반적인 git 워크플로우로 커밋하세요; 서버는 파일을 작성하고 저장소에는 손대지 않습니다.

예시 세션 (요약)

You:   Convert the first twenty documents in /archive to Markdown with front matter
       and images as files. Report format, pages and output size for each.
Agent: convert_to_markdown (frontMatter: true, images: "file") x 20
       ops-manual-2014.docx   DOCX   88 pages   converted
       install-guide.chm      CHM    41 pages   converted
       supplier-forms-2009.pdf PDF   12 pages   1 KB of Markdown: probably a scan
       Nineteen files look consistent; one scan needs separate handling.

솔직한 제한 사항

라이선스가 없으면 평가 모드는 각 문서의 처음 3페이지만 처리하고 각 페이지에 평가 워터마크를 삽입합니다. 이 상태에서 마이그레이션을 실행하면 수백 개의 짧은 파일이 생성되며 겉보기에는 정상적이지만, 누락된 절차를 검색할 때 몇 주 후에 차이가 발견됩니다. 마이그레이션에는 라이선스가 필요하므로 첫 배치 전에 get_license_status를 실행하십시오. 스캔된 PDF는 변환되지 않습니다.

FAQ

수백 개의 Word 문서를 한 번에 Markdown으로 변환할 수 있나요?

예, 하지만 한 번에 하나의 프롬프트로는 불가능합니다. 약 20개씩 배치로 변환하고 각 배치 후에 보고서를 확인하여 잘못된 옵션이 전체 아카이브에 적용되기 전에 수정합니다.

AI 에이전트를 사용해 문서를 git에 마이그레이션하려면 어떻게 해야 하나요?

서버는 .md 파일과 이미지 파일을 출력 폴더에 작성합니다. 이를 검토하고 일반적인 git 워크플로우로 커밋하십시오.

docs-as-code 마이그레이션이 내 문서를 업로드하나요?

아니요. GroupDocs.Markdown.Mcp는 로컬 프로세스이며, 아카이브는 디스크에서 읽습니다. 에이전트가 대화에서 작성한 내용만 모델 제공자에게 전달됩니다.

더 깊이 파고들기