Pandoc Word to Markdown: 명령줄 변환 가이드

Pandoc는 가장 강력한 문서 변환 도구입니다. .docx를 Markdown로 변환하는 등 수십가지의 형식을 변환하고, 출력에 대한 정밀한 통제권을 제공합니다. 이 가이드 는 사용 해야 할 모든 것 을 다룬다 Pandoc를 위해 Word에서 Markdown까지 변환

Pandoc 는 무엇 입니까?

Pandoc는 문서를 다른 형식으로 변환하는 무료, 오픈 소스 명령줄 도구입니다. 40개 이상의 입력 및 출력 형식을 지원합니다. Word에서 Markdown 변환을 위해, Pandoc는 골드 스탠더드이며, 브라우저 기반 도구보다 더 구성 가능합니다. WordToMD.

Pandoc와 비교할 때 WordToMD:

Pandoc 설치

윈도우

이 페이지에서 설치 프로그램을 다운로드 pandoc.org/설치.html, 또는 패키지 관리자를 사용:

# Winget
winget install pandoc

# Chocolatey
choco install pandoc

# Scoop
scoop install pandoc

macOS

# Homebrew
brew install pandoc

# MacPorts
sudo port install pandoc

리눅스

# Ubuntu/Debian
sudo apt-get install pandoc

# Fedora
sudo dnf install pandoc

# Arch
sudo pacman -S pandoc

설치 확인:

pandoc --version

기본 변환 명령어

pandoc document.docx -o output.md

다 됐어 Pandoc에서 입력 형식을 추론 .docx 그리고 출력 형식 .md.

더 명확한 버전:

pandoc -f docx -t markdown document.docx -o output.md

출력 형식 옵션

Pandoc는 여러 Markdown 변형을 출력으로 제공합니다:

# GitHub Flavored Markdown (GFM)
pandoc document.docx -t gfm -o output.md

# CommonMark
pandoc document.docx -t commonmark -o output.md

# Pandoc's extended Markdown (most features)
pandoc document.docx -t markdown -o output.md

# Standard Markdown (basic)
pandoc document.docx -t markdown_strict -o output.md

GFM는 권장됩니다 대부분의 경우 (GitHub, Obsidian, GitBook, Notion)

유용한 변환 옵션

미디어 파일을 추출

.docx에 삽입된 이미지는 디렉토리에 추출됩니다:

pandoc document.docx --extract-media=./media -o output.md

이것은 이미지를 저장합니다. ./media/ 그리고 Markdown 이미지 참조를 출력으로 추가합니다.

포착 라인

출력에서 제어 라인 포착:

# No wrapping (one paragraph = one line)
pandoc document.docx --wrap=none -o output.md

# Wrap at 80 characters
pandoc document.docx --wrap=auto --columns=80 -o output.md

--wrap=none 버전 제어되는 Markdown에 권장됩니다. 더 깔끔한 Git difs를 생성합니다.

내용 목록

pandoc document.docx --toc -o output.md

메타데이터를 포함하는 독립 문서

pandoc document.docx -s -o output.md

해당 -s (자립) 플래그는 문서의 메타데이터에서 YAML 프론트마터를 생성합니다.

배치 변환

디렉토리의 모든 .docx 파일을 변환:

윈도우 파워 셸

Get-ChildItem -Filter "*.docx" | ForEach-Object {
    $output = [System.IO.Path]::ChangeExtension($_.Name, ".md")
    pandoc $_.FullName -t gfm --wrap=none -o $output
    Write-Host "Converted: $($_.Name) → $output"
}

Bash (macOS/Linux)

for file in *.docx; do
    output="${file%.docx}.md"
    pandoc "$file" -t gfm --wrap=none -o "$output"
    echo "Converted: $file → $output"
done

더 많은 배치 변환 옵션에 대해, 참조 배치 변환 Word to Markdown.

Lua 필터로 출력을 사용자 정의

Pandoc는 변환 중에 문서 AST를 변환하는 Lua 필터를 지원합니다:

pandoc document.docx --lua-filter=my-filter.lua -o output.md

사용자 정의 프론트마터 블록을 추가하기 위한 Lua 필터 예:

-- add-frontmatter.lua
function Meta(meta)
  meta.draft = false
  meta.author = "WordToMD Team"
  return meta
end

이것은 브라우저 도구가 대응할 수 없는 사용자 정의의 종류입니다.

Pandoc와 매머스.js의 출력을 비교

WordToMD 모토 밑에서 매머스 P A 를 사용했어요. Pandoc는 자체 파저를 사용합니다. 주요 차이점:

복잡한 문서의 경우 Pandoc는 더 완전한 출력을 제공합니다. 간단한 문서를 위해 WordToMD는 제로 설정으로 더 빨라집니다.

Pandoc 기본 파일

동일한 설정으로 반복 변환을 하는 경우, 기본 파일:

# my-defaults.yaml
from: docx
to: gfm
wrap: none
extract-media: ./media
standalone: true

그럼 실행해

pandoc document.docx -d my-defaults.yaml -o output.md

CI/CD에서 Pandoc를 사용함

자동화 된 파이프라인 (GitHub 액션 등):

# .github/workflows/convert-docs.yml
- name: Install Pandoc
  run: sudo apt-get install pandoc

- name: Convert Word docs to Markdown
  run: |
    for f in docs/*.docx; do
      pandoc "$f" -t gfm --wrap=none -o "${f%.docx}.md"
    done

FAQ

Pandoc 출력 \ 제 Markdown에서 줄의 연속입니다. 어떻게 제거할까요? 추가 --wrap=none 단단한 라인 포장을 비활성화하기 위해서요.

제 테이블은 Pandoc 출력에서 엉망으로 보입니다. 시도해봐 -t gfm GFM 테이블 문법에서 기본 Pandoc Markdown 테이블 대신

이미지는 출력에서 표시되지 않습니다. 추가 --extract-media=./images 임베디드 이미지를 추출하기 위해서죠. 그런 다음 목표 환경에서 그것들을 올바르게 참조하세요.

Pandoc는 스마트 코팅을 " 글자 어떻게 보관할까요? 추가 --no-highlight 또는 템플릿을 수정합니다. 특히 스마트 코팅의 경우, 대부분의 출력 형식에서 기본적으로 보존되어야 합니다.

Pandoc와 WordToMD는 DOCX와 Markdown의 비교는 어떻게 될까요? 두 가지 모두 표준 문서에 적합합니다. WordToMD는 0의 설정이 필요하며 깨끗한 GFM 출력을 생성합니다. Pandoc는 설치가 필요하지만 복잡한 문서 (사진, 수학, 댓글, 발음) 를 더 완벽하게 처리합니다.

결론

Pandoc는 가장 유능한 도구입니다 Word를 Markdown으로 변환, 특히 배치 처리, 사용자 정의 출력 형식 및 CI/CD 파이프라인. 설치 없이 단번에 한 번만 변환할 수 있는 WordToMD 직후에 일을 끝낼 수 있습니다. 이 두 도구는 서로 잘 보완됩니다.