Pandoc Markdown→Word 변환 — 한글·표·그림 확인

저장한 Markdown을 Word 사본으로 바꾸는 한 과업입니다. 도구 선택·무료 범위·설치 방식은 Pandoc 프로그램 안내에서 확인하세요. Typora에서 문서를 쓰는 환경과 무료 변환만 필요한 상황도 구분할 수 있습니다.

원본 Markdown과 그 안에서 참조하는 그림을 함께 보관합니다. 상대 그림 경로는 폴더 구조에 영향을 받습니다. UTF-8 파일로 작은 샘플을 먼저 시험하고 제출할 결과 이름을 원본과 구분하세요.

한글·표·그림 연습 파일 받기에는 자체 Markdown, 그림, 참조 스타일 DOCX, 확인한 결과 DOCX가 들어 있습니다. ZIP을 풀고 새 결과 이름으로 연습하세요. 프로그램 실행 파일은 포함하지 않았습니다.

설치 없이 시작할 필요가 있으면 공식 Pandoc 웹 앱의 지원 형식과 파일 추가 경로도 비교하세요. 아래 명령과 검증 결과는 Windows의 독립 CLI 기준이며 Typora 메뉴나 웹 앱 출력과 같다는 의미는 아닙니다.

이미 Pandoc CLI를 준비했다면 터미널에서 pandoc --version을 실행해 도구를 찾을 수 있는지 확인합니다. 명령이 인식되지 않으면 CLI 설치·경로를 확인하고, 실행 파일의 전체 경로를 따옴표로 감싸 사용할 수 있습니다. PowerShell에서 전체 경로 실행은 & "C:\경로\pandoc.exe" --version처럼 호출합니다.

예제 ZIP을 푼 폴더에서 터미널을 열고 다음 명령으로 새로운 DOCX를 만듭니다. pandoc "sample document.md" --from=markdown --to=docx --output="my result.docx"

입력은 저장한 Markdown, 출력은 별도 사본입니다. 예제는 Pandoc의 markdown 입력 형식으로 시험했습니다. 다른 Markdown 확장 문법을 사용한 문서는 맞는 입력 형식과 지원 여부를 확인하세요. 공백이 있는 파일·폴더 이름은 따옴표로 감쌉니다.

그림이 빠졌다면 원본의 그림 파일과 상대 경로, 현재 작업 폴더를 확인합니다. 입력 Markdown의 전체 경로를 지정했어도 그림 검색 폴더까지 자동으로 같아졌다고 판단하지 마세요. 시험에서는 다른 폴더에서 변환한 DOCX가 생성됐지만 그림은 누락됐습니다.

원본 폴더에서 실행하거나 --resource-path로 검색할 폴더를 지정합니다. Windows에서 여러 폴더를 나열할 때는 세미콜론을 사용하고, macOS·Linux에서는 콜론을 사용합니다. 이 옵션을 지정하면 필요한 현재 폴더도 목록에 포함하세요.

Windows에서 현재 폴더와 예제 원본 폴더를 함께 검색하는 예시입니다. 실제 원본 위치로 바꿉니다. pandoc "C:\문서 폴더\sample document.md" --from=markdown --to=docx --resource-path=".;C:\문서 폴더" --output="my result.docx"

터미널의 그림 관련 경고를 읽고 생성 문서를 다시 엽니다. 경고가 사라졌는지뿐 아니라 필요한 그림이 실제로 보이는지 대조하세요. 공식 자원 경로 설명에서 현재 환경의 조건을 확인할 수 있습니다.

글꼴·제목 크기·종이 크기 같은 DOCX 출력 조건을 맞추려면 --reference-doc에 참조 DOCX를 지정합니다. 참조 문서의 스타일과 문서 속성을 사용하며 본문을 결과에 복사하는 기능은 아닙니다.

예제 폴더에서는 제공한 reference.docx를 사용해 별도 결과를 만들 수 있습니다. pandoc "sample document.md" --from=markdown --to=docx --resource-path="." --reference-doc="reference.docx" --output="my styled result.docx"

참조 파일에는 A4·맑은 고딕과 제목 크기를 지정했습니다. 자신의 환경에서 사용 가능한 글꼴인지 확인하고 필요하면 DOCX의 스타일·문서 속성을 조정한 사본을 참조하세요. 본문을 직접 꾸민 것과 스타일을 수정한 것은 다를 수 있습니다.

참조 파일을 지정했다고 복잡한 원본 배치나 모든 문법의 모양이 그대로 유지되는 것은 아닙니다. 필요한 조건을 한 가지씩 바꾸고 생성한 문서를 확인하세요. 세부 조건은 공식 DOCX 참조 설명을 따릅니다.

Windows Pandoc 3.12.1에서 자체 한글·제목·목록·표 1개·그림 1개를 시험했습니다. 작업 폴더가 달라 그림이 빠진 결과와 자원 경로를 지정해 복원한 결과를 대조했고, 참조 스타일과 원본 보존을 확인했습니다. 기본 결과와 A4 참조 결과는 실제 Word 출력 화면도 확인했습니다. 작은 샘플의 결과를 모든 문서나 Typora GUI 출력에 적용하지 않습니다.

• 명령을 찾지 못하면 Pandoc 설치·실행 파일 경로를 확인합니다.
• 그림 누락은 작업 폴더·상대 경로·자원 검색 목록부터 대조합니다.
• 글꼴·종이 조건이 다르면 사용 가능한 글꼴과 참조 DOCX의 스타일·문서 속성을 확인합니다.
• 표·확장 문법 결과가 다르면 입력 형식과 지원 범위, 원본 구조를 살펴봅니다.

필요한 항목을 한 가지씩 바꾸며 새 사본을 만듭니다. 원본을 지우거나 기존 결과를 덮어쓰지 않아도 확인할 수 있습니다. 지면 배치가 중요한 문서는 생성 DOCX를 사용할 편집기에서 최종 대조하세요.