LibreOffice CLI를 사용하여 DOCX 파일을 PDF로 일괄 변환

Word 파일이 있는 폴더가 있다면 LibreOffice를 사용하여 한 번의 명령으로 변환할 수 있습니다. DOCX 파일이 있는 폴더에서 빈 출력 폴더를 만들고 다음 명령을 실행하세요 libreoffice --headless --convert-to pdf:writer_pdf_Export --outdir pdf *.docx. 이 명령은 Writer의 PDF 내보내기 필터를 사용하며 원본 파일은 그대로 남겨둡니다.

새로운 출력 폴더를 사용하고, LibreOffice가 설치되어 있는지 확인하고, 명령 실행이 성공적으로 완료되었다고 해서 모든 페이지가 제대로 표시된다고 생각하지 말고 생성된 PDF 파일을 검토하십시오. 명령줄은 편리한 일괄 처리 도구일 뿐이며, Microsoft Word와 동일한 페이지 매김을 보장하거나 손상된 문서를 복구하는 것은 아닙니다.

간단한 일괄 변환을 실행하세요

리눅스에서 파일이 있는 디렉토리에서 터미널을 엽니다. 먼저 출력 디렉토리를 생성하세요.

mkdir -p pdf
libreoffice --headless --convert-to pdf:writer_pdf_Export --outdir pdf *.docx

--headless일반 데스크톱 창을 열지 않고 실행됩니다. --convert-to대상 형식으로 PDF를 선택하고, writer_pdf_ExportLibreOffice Writer의 PDF 내보내기 필터를 지정하며, --outdir pdf결과를 지정된 pdf폴더에 저장합니다. LibreOffice가 시작되기 전에 셸이 일치하는 파일로 확장됩니다 . LibreOffice는 명령줄 매개변수 참조 및 파일 변환 필터 목록*.docx 에 이 변환 구문과 필터 이름을 문서화합니다 .

리눅스 터미널에 LibreOffice 배치 명령어가 DOCX 파일을 PDF로 변환하고 생성된 PDF 파일 목록을 보여줍니다.
다음은 소량의 DOCX 파일을 LibreOffice의 Writer PDF 내보내기 필터를 사용하여 전송한 후의 터미널 출력 예시입니다.

올바른 배치 패턴을 선택하세요

와일드카드 명령어는 모든 DOCX 파일이 하나의 입력 폴더 안에 있을 때 가장 효과적입니다. 하위 폴더는 검색하지 않습니다. Linux에서는 기본적으로 대소문자를 구분하므로 . *.docx으로 끝나는 파일은 건너뛸 수 있습니다 .DOCX. 셸에서 패턴이 일치하지 않는다는 메시지가 표시되면 파일을 나열하고 확장자를 확인한 후 명령어를 변경하십시오.

하위 폴더에 중첩된 문서의 경우, 루프를 사용하면 디렉터리 구조를 유지하고 두 폴더에 동일한 이름의 파일이 있을 때 충돌을 방지할 수 있습니다. input소스 트리와 pdf대상 트리를 각각 설정하십시오.

input="$PWD/input"
output="$PWD/pdf"
profile="file:///tmp/lo-batch-profile"

find "$input" -type f -iname '*.docx' -print0 |
while IFS= read -r -d '' file; do
  rel="${file#"$input"/}"
  dest="$output/$(dirname "$rel")"
  mkdir -p "$dest"
  libreoffice --headless \
    -env:UserInstallation="$profile" \
    --convert-to pdf:writer_pdf_Export \
    --outdir "$dest" "$file"
done

-print0또한 read -d ''일치 검색 기능은 파일 이름에 공백 및 대부분의 특수 문자를 안전하게 처리합니다. 별도의 프로필을 -env:UserInstallation사용하면 이 배치 작업이 동일한 사용자 프로필을 사용하는 데스크톱 LibreOffice 세션과 충돌하는 것을 방지할 수 있습니다. LibreOffice 시작 참조 문서를 확인하세요. 두 개의 변환 작업이 동시에 실행될 수 있는 경우 고유한 프로필 경로를 사용하십시오. 검색이 이전 결과로 넘어가지 않도록 출력 트리를 입력 트리 외부에 유지하십시오.

리눅스 터미널에 검색 기반 루프가 실행되어 중첩된 폴더에서 일치하는 PDF 출력 폴더로 문서를 전송하는 모습이 표시됩니다.
각 소스 폴더 옆에 있는 pdf 하위 폴더에 PDF 파일을 저장하는 재귀적 찾기 루프의 예입니다. 이렇게 하면 같은 이름의 파일이 다른 폴더에 있어도 서로 분리됩니다.

LibreOffice가 이미 열려 있는 경우

명령이 파일을 생성하지 않고 완료된 것처럼 보이거나 기존 LibreOffice 프로세스에 연결될 수 있습니다. 실행 중인 데스크톱 인스턴스에 기본 사용자 프로필이 남아 있을 수 있습니다. LibreOffice를 닫고 다시 시도하십시오. 무인 작업의 경우 -env:UserInstallation재귀 예제의 격리 옵션이 유용한 안전 장치입니다. 각 동시 작업에 고유한 프로필 디렉터리를 할당하고 하나의 작업이 완료될 때까지 기다린 후 해당 디렉터리를 다시 사용하십시오.

명령에 LibreOffice를 운영 체제에서 지원하는 패키지 소스를 통해 설치하라는 메시지가 표시되면 libreoffice: command not found실행 파일의 전체 경로를 사용하십시오. Windows PowerShell에서는 간단한 비재귀 배치 파일을 다음과 같이 작성할 수 있습니다.

$src = (Resolve-Path .).Path
$out = Join-Path $src 'pdf'
New-Item -ItemType Directory -Force -Path $out | Out-Null
$soffice = "$env:ProgramFiles\LibreOffice\program\soffice.exe"
Get-ChildItem -File -Filter *.docx | ForEach-Object {
  & $soffice --headless --convert-to pdf:writer_pdf_Export --outdir $out $_.FullName
}

LibreOffice가 다른 위치에 설치되어 있는 경우 설정을 조정하십시오 $soffice. 소스 폴더에서 명령을 실행하고 새 출력 폴더를 사용하십시오. PowerShell은 Get-ChildItem -File재귀 검색이 요청되지 않는 한 해당 폴더만 검색합니다. 재귀 작업을 수행하려면 각 소스 경로에 해당하는 대상 폴더를 생성하는 루프가 필요합니다.

결과에 영향을 미칠 수 있는 요인은 무엇일까요?

PDF 변환 시 LibreOffice에서 인식할 수 있는 레이아웃은 유지되지만, Word와 LibreOffice에서 문서의 페이지 매김 방식이 항상 동일하지는 않습니다. 누락된 글꼴, 지원되지 않는 포함된 개체, 변경 내용 추적, 필드 또는 복잡한 표로 인해 줄 바꿈 및 페이지 수가 달라질 수 있습니다. 일관된 서식을 유지하려면 변환 전에 문서에 필요한 글꼴을 설치하십시오. 보호되거나 암호로 암호화된 파일은 자격 증명을 사용하여 열거나 수동으로 처리해야 할 수 있으며, 손상된 DOCX 파일은 다른 파일은 변환되더라도 변환이 실패할 수 있습니다.

이름이 같은 중요한 PDF 파일이 있는 폴더에 일괄 처리 파일을 반복적으로 실행하지 마십시오. 깨끗한 저장 위치를 ​​사용하거나 기존 출력 파일을 먼저 백업하십시오. 특히 중요한 파일이 있는 경우, PDF 파일을 사용하기 전에 LibreOffice Writer에서 해당 파일을 열어 내용을 확인하십시오. Microsoft Word의 정확한 페이지 매김이 계약상 요구되는 사항이라면 LibreOffice가 적합하지 않을 수 있습니다. 필요한 레이아웃을 정의하는 응용 프로그램에서 대표 샘플을 비교해 보십시오.

Linux 터미널에서 PDF 내보내기 전에 별도의 사용자 설치 프로필을 사용하여 LibreOffice가 헤드리스 모드로 실행 중임을 보여줍니다.
무인 변환 실행을 위해 별도의 LibreOffice 사용자 프로필을 사용하는 예시 명령입니다.

공유하기 전에 출력 결과를 확인하세요.

먼저 원본 파일 수와 PDF 파일 수를 비교합니다. Linux에서는 다음 명령어를 사용하여 플랫 폴더에 있는 파일 수를 계산할 수 있습니다.

find . -maxdepth 1 -type f -iname '*.docx' | wc -l
find pdf -maxdepth 1 -type f -iname '*.pdf' | wc -l

재귀 변환의 경우, 전체 입력 및 출력 트리에서 개수를 비교하십시오. 개수 일치는 유용한 검사 도구일 뿐 품질을 보장하는 것은 아닙니다. 손상된 문서나 덮어쓰기된 중복 파일이 있는 경우 검토가 필요할 수 있습니다. 터미널 로그에서 오류를 확인하고 대상 폴더에 예상되는 파일 이름이 모두 있는지 확인하십시오.

PDF 뷰어를 사용하여 대표적인 PDF 파일을 검사하십시오. 첫 페이지와 마지막 페이지, 페이지 수, 여백, 표, 머리글과 바닥글, 이미지, 그리고 중요한 페이지 나누기를 확인하십시오. PDF 뷰어가 pdfinfo설치되어 있는 경우, pdfinfo pdf/Report.pdf페이지 수와 페이지 크기 등의 메타데이터를 제공하지만, 시각적 품질은 평가하지 않습니다. 누락된 글꼴을 설치하거나 출력 디렉터리를 변경하는 등 특정 문제를 해결한 후에만 다시 변환하고, 영향을 받는 PDF 파일을 다시 검토하십시오.

리눅스 터미널에서 변환된 PDF 파일의 페이지 수, 페이지 크기 및 파일 크기를 보여주는 pdfinfo 출력 결과를 확인할 수 있습니다.
페이지 수 및 용지 크기와 같은 PDF 메타데이터를 보여주는 검증 화면 예시입니다.

모든 예상 PDF 파일이 존재하고, 오류 없이 열리며, 중요한 페이지의 레이아웃이 의도된 대로 유지되면 일괄 처리가 완료된 것입니다. 대용량 아카이브의 경우, 개별 오류가 발생했을 때 관련 없는 출력물을 덮어쓰지 않고 문제를 추적하고 다시 실행할 수 있도록 원본 DOCX 파일과 변환 로그를 보관하십시오.

댓글 남기기

Xwayland를 사용하는 Wayland 환경에서 Element Desktop이 충돌하는 문제를 해결합니다.

Xwayland를 통해 Element Desktop을 테스트하고, 로컬 데이터를 보존하며, Linux Wayland에서 앱이 충돌할 때 그래픽 또는 패키지 문제를 격리하십시오.

Google 서비스 없이 Element Android 알림을 받으세요

UnifiedPush 및 ntfy를 사용하여 Element Android를 설정한 다음, 알림이 실패할 경우 자체 호스팅 Matrix 게이트웨이 및 Android 백그라운드 설정을 확인하십시오.

Nextcloud 아이폰 사진 업로드 기능을 백그라운드에서 실행하세요

Nextcloud 아이폰 사진 업로드 기능을 백그라운드에서 실행하세요

Nextcloud 업로드 설정, iOS 권한, 배터리 모드 및 iPhone 백그라운드 예약 기능의 제한 사항을 확인하여 백그라운드 사진 감지 기능을 복원하세요.

ONLYOFFICE Desktop에서 더 선명한 텍스트 보기: Linux에서 글꼴 힌팅 설정 조정

ONLYOFFICE Desktop에서 더 선명한 텍스트 보기: Linux에서 글꼴 힌팅 설정 조정

ONLYOFFICE의 글꼴 힌팅 모드를 비교하고, 확대/축소 및 Linux 글꼴 사용 가능 여부를 확인하고, 흐림 효과가 편집기에만 적용되는지 아니면 데스크톱 전체에 영향을 미치는지 검증하십시오.

ONLYOFFICE Desktop에서 PDF 파일을 편집 가능한 DOCX 파일로 변환하기

ONLYOFFICE Desktop에서 PDF 파일을 편집 가능한 DOCX 파일로 변환하기

ONLYOFFICE 데스크톱 편집기에서 PDF를 로컬로 변환한 다음 DOCX 파일을 검토하여 레이아웃 변경 사항, 스캔한 페이지 및 수정이 필요한 텍스트를 확인하십시오.

ONLYOFFICE 데스크톱 편집기를 ownCloud 파일에 연결하세요

ONLYOFFICE 데스크톱 편집기에 ownCloud 계정을 추가하고, 연결을 통해 얻을 수 있는 이점을 이해한 다음, 직접 액세스, 동기화 및 브라우저 편집 중에서 선택하세요.

ONLYOFFICE 모바일 시간 초과 오류를 해결하려면 서버 URL을 확인하세요.

ONLYOFFICE 모바일 시간 초과 오류를 해결하려면 서버 URL을 확인하세요.

올바른 포털 또는 WebDAV 주소를 사용하고, 휴대폰에서 HTTPS 연결 가능 여부를 테스트하고, 사설 네트워크, TLS 및 로그인 문제를 구분하십시오.

ONLYOFFICE 데스크톱 플러그인 개발 및 디버깅 활성화

ONLYOFFICE 데스크톱 플러그인 개발 및 디버깅 활성화

ONLYOFFICE 데스크톱 편집기용 사용자 지정 플러그인을 빌드하고 테스트한 다음, 해당 .plugin 아카이브를 설치하고 디버깅을 위해 개발자 도구를 활성화합니다.

LibreOffice의 매크로 시스템을 통해 Calc에서 Python 실행하기

LibreOffice의 매크로 시스템을 통해 Calc에서 Python 실행하기

Calc에서 Python 함수를 사용할 수 있도록 만들고, 열려 있는 스프레드시트에서 해당 함수를 실행하고, LibreOffice와 시스템 Python을 혼동하지 않고 누락된 매크로 또는 가져오기 문제를 해결하세요.

선택한 작성자 텍스트를 섹션 암호로 보호하세요

선택한 작성자 텍스트를 섹션 암호로 보호하세요

Writer 문서의 나머지 부분은 계속 사용할 수 있도록 유지하면서 특정 구절에 대한 일반적인 편집을 차단하는 방법과 파일 암호화가 더 나은 선택인 경우를 알아보세요.