정적 사이트로 문서를 게시하려면 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.
정적 사이트 생성기가 문서에서 필요로 하는 것은 무엇인가요?
세 가지: 본문을 위한 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는 이 블로그의 생성기이므로 여기서는 예시로 사용합니다. 흐름은 네 단계이며, 에이전트가 모두 수행합니다.
- Convert. 위 프롬프트를 문서 폴더에 실행합니다.
- Arrange. 서버가 파일을 작성합니다; 레이아웃은 에이전트의 작업입니다.
각 변환된 파일을 문서 이름을 딴 폴더에 넣고, 이미지들은 그 옆에
images하위 폴더에 배치하십시오. - Add the keys the theme wants. Hugo 테마는 종종
date또는weight를 기대합니다. 도구가 이를 작성하지 않으므로 요청하세요:weight를 각 파일의 프런트 매터에 추가하고, 제가 나열한 순서대로 번호를 매겨 주세요. - Build. 직접 Hugo를 실행합니다. 이 시점에서 파일은 프런트 매터가 포함된 일반 Markdown이며, 생성기는 이를 일반 페이지처럼 처리합니다.
Docusaurus와 MkDocs도 동일한 출력이 적용됩니다; 폴더 레이아웃과 추가 키만 다르며, 이를 두 번째와 세 번째 프롬프트에서 설명하면 됩니다.
예시 세션 (요약)
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.
게시하기 전에 결과를 어떻게 확인하나요?
두 가지 검사가 거의 모든 문제를 포착합니다:
각 변환된 파일에 대해 원본의 페이지 수와 Markdown 길이를 비교하십시오.
60페이지 문서가 3KB Markdown으로 변환되었다면 스캔된 PDF이거나 평가 모드 실행입니다.
각 문서의 이미지 폴더와 Markdown이 참조하는 이미지를 나열하십시오.
이미지를 전혀 쓰지 않은 .md 파일은 사이트에서 깨진 이미지로 표시됩니다. 200개 정도의 배치를 진행하기 전에 가장 복잡한 소스를 샘플 체크하십시오.
Word와 Excel 소스는 구조가 그대로 유지됩니다: 헤딩은 헤딩이 되고 표는 Markdown 표가 됩니다. PDF는 제작 방식에 따라 다릅니다. 디지털 원본으로 내보낸 경우는 깨끗하게 변환되지만, 스캔본은 OCR 단계가 없기 때문에 유용하게 변환되지 않습니다.
프런트 매터 키는 직접 어떤 것을 추가하나요?
frontMatter: true는 제목, 저자, 형식 및 페이지 수를 작성합니다. 각 파일에서 해당 값을 확인하고 비어 있거나 잘못된 경우 에이전트에게 수정하도록 요청하십시오. 네비게이션, 정렬, 태그 및 날짜는 변환 후 단계 3에서 추가하는 키입니다. 더 풍부한 문서 속성을 프런트 매터에 포함하려면 이 서버를 GroupDocs.Metadata.Mcp와 결합하고, 에이전트가 키를 추가하도록 하면 됩니다; 이 게시물에서는 다루지 않습니다.
솔직한 제한 사항
라이선스가 없으면 서버는 평가 모드로 실행되며 첫 3페이지만 처리되고 각 페이지에 평가 워터마크가 삽입됩니다. 라이선스 없이 출력된 사이트는 긴 문서의 3페이지 요약만 제공됩니다. 변환하기 전에 get_license_status를 실행하고, “원본 대비 길이” 검사를 루프에 유지하십시오.
FAQ
Word를 Hugo Markdown으로 어떻게 변환하나요?
에이전트에게 frontMatter: true, images: "file" 및 flavor: "github" 옵션으로 문서를 변환하도록 요청한 뒤, 파일을 콘텐츠 폴더에 배치하도록 지시하십시오. weight와 같은 테마 전용 키는 두 번째 프롬프트에서 추가합니다.
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