Como converter arquivos DOCX para PDF em lote usando a linha de comando do LibreOffice

Se você tiver dezenas de documentos do Word, abrir cada um no LibreOffice e exportá-los separadamente é um processo lento e fácil de interromper. Um comando como ` soffice --convert-to pdfconvert` pode converter um lote, mas problemas comuns incluem o envio de PDFs para a pasta errada, a perda de nomes de arquivos com espaços, a anexação da tarefa a uma janela já aberta pelo LibreOffice ou a geração de PDFs com layout diferente do Word. O fluxo de trabalho abaixo começa com um arquivo de teste, passa para um comando em lote seguro e termina com verificações de saída ausente ou malformada.

Estes exemplos utilizam a sintaxe atual da linha de comando do LibreOffice, documentada na Ajuda do LibreOffice 26.8, consultada em 6 de outubro de 2026. Eles usam writer_pdf_Exporto filtro de exportação para PDF para documentos do Writer. A conversão é adequada para arquivos DOCX comuns, mas layouts complexos ainda precisam ser revisados, pois o LibreOffice e o Microsoft Word podem renderizar algumas fontes e layouts de página de forma diferente.

Antes de converter uma pasta

Instale o LibreOffice no computador que executará a conversão. Em um servidor, use o gerenciador de pacotes ou o instalador do sistema e confirme se ele sofficeestá disponível no prompt de comando. No Windows, o executável geralmente está em `/usr/local /bin` C:\Program Files\LibreOffice\program\soffice.exe; o caminho de instalação pode variar.

Prepare duas pastas separadas: uma para os arquivos DOCX de origem e outra para os PDFs resultantes. Comece com uma pasta de saída nova ou vazia. Se você converter para uma pasta que já contém PDFs com os mesmos nomes base, o LibreOffice pode perguntar se deseja sobrescrevê-los ou não conseguir substituí-los, dependendo do processo e do ambiente. Manter as pastas de origem e saída separadas também evita um loop de conversão acidental quando scripts verificam um diretório.

Para documentos com fontes incomuns, instale as mesmas fontes usadas pelo autor original antes da conversão. A ausência de fontes pode alterar quebras de linha, número de páginas, largura das tabelas e paginação, mesmo que o arquivo DOCX abra sem erros.

1. Teste primeiro um arquivo DOCX.

Converta um documento representativo antes de executar um lote grande. Nos exemplos abaixo, substitua os caminhos de exemplo pelos seus próprios:

mkdir -p "/srv/docs/converted"
soffice --headless --convert-to pdf:writer_pdf_Export --outdir "/srv/docs/converted" "/srv/docs/incoming/Annual Report.docx"

--headlessExecuta o LibreOffice sem abrir sua interface gráfica. --convert-toSeleciona o formato de saída e o filtro opcional, além de --outdirnomear o destino. A tabela de filtros do LibreOffice lista writer_pdf_Exportos formatos para saída em PDF a partir do Writer. Revise o PDF de teste antes de converter tudo: verifique quebras de página, cabeçalhos e rodapés, tabelas, imagens, hiperlinks e caracteres especiais.

Se o teste não gerar nenhum PDF, confirme se o caminho de origem está correto, se o arquivo é legível e se a pasta de saída tem permissão de escrita. Verifique também se o LibreOffice está instalado na mesma conta que executa o comando. Referências oficiais: Filtros de conversão de arquivos do LibreOffice e parâmetros de linha de comando do LibreOffice .

2. Converter todos os arquivos DOCX em um único comando Bash

No Linux ou macOS, abra o Bash em um terminal e use um padrão de nome de arquivo. Certifique-se sofficede que ele esteja no seu PATHPATH; no macOS, talvez seja necessário executar o arquivo dentro do pacote do aplicativo LibreOffice. Este exemplo lida com arquivos DOCX diretamente dentro de uma pasta de entrada:

src="/srv/docs/incoming"
out="/srv/docs/converted"

mkdir -p "$out"
soffice --headless --convert-to pdf:writer_pdf_Export --outdir "$out" "$src"/*.docx

O Bash expande *.docxos argumentos de arquivo separadamente antes de iniciar o LibreOffice. Como cada caminho é passado como um argumento, os espaços em nomes de diretórios e arquivos são preservados. O PDF de saída mantém a raiz do nome do arquivo original, portanto, Annual Report.docxtorna-se Annual Report.pdf. O comando processa apenas os arquivos nessa pasta; ele não pesquisa pastas secundárias.

Use uma pasta de destino vazia na primeira execução. Antes de executar o comando com curinga, verifique se a pasta de entrada contém os arquivos desejados e se você tem espaço em disco suficiente para os PDFs. No Bash, um curinga não correspondido pode permanecer literal, a menos que você configure opções do shell; se houver possibilidade de a pasta estar vazia, primeiro verifique se há pelo menos um arquivo DOCX ou use o loop por arquivo na próxima seção.

3. Use um loop para pastas grandes ou tratamento explícito de erros.

Um shell pode rejeitar uma lista de argumentos muito longa quando uma pasta contém milhares de documentos. Um loop evita o envio de todos os nomes de arquivo para o sistema operacional em um único comando e lida com espaços de forma segura quando os caminhos estão entre aspas.

src="/srv/docs/incoming"
out="/srv/docs/converted"
mkdir -p "$out"

found=false
for file in "$src"/*.docx; do
  [ -f "$file" ] || continue
  found=true
  soffice --headless --convert-to pdf:writer_pdf_Export --outdir "$out" "$file" || {
    printf 'Conversion failed: %s\n' "$file" >&2
  }
done
[ "$found" = true ] || { echo 'No DOCX files found.' >&2; exit 1; }

O forloop entre aspas lida com nomes de arquivos que contêm espaços e não envia a lista completa de arquivos como um único argumento grande. Ele executa uma conversão do LibreOffice por arquivo, portanto, pode demorar mais do que o comando com um único caractere curinga. Ele examina apenas os arquivos diretamente dentro da pasta de entrada. Para incluir subpastas, use uma pesquisa recursiva de arquivos e preserve cada pasta de entrada no layout de saída; caso contrário, dois arquivos com o mesmo nome base podem gerar nomes de PDF conflitantes.

4. Converter uma pasta no Windows PowerShell

No PowerShell, passe cada caminho completo como um único argumento. O loop a seguir lista os arquivos para os quais o LibreOffice retorna um código de saída diferente de zero:

$soffice = 'C:\Program Files\LibreOffice\program\soffice.exe'
$inputDir = 'C:\Documents\incoming'
$outputDir = 'C:\Documents\converted'

New-Item -ItemType Directory -Force -Path $outputDir | Out-Null
$files = Get-ChildItem -LiteralPath $inputDir -Filter '*.docx' -File
if ($files.Count -eq 0) {
    throw "No DOCX files found in $inputDir"
}

$failed = @()
foreach ($file in $files) {
    & $soffice --headless --convert-to pdf:writer_pdf_Export --outdir $outputDir $file.FullName
    if ($LASTEXITCODE -ne 0) {
        $failed += $file.FullName
    }
}
if ($failed.Count -gt 0) {
    Write-Warning "Review failed conversions: $($failed -join '; ')"
}

Altere $sofficese o LibreOffice estiver instalado em outro local. Get-ChildItemO exemplo do PowerShell não é recursivo; adicione- -Recurseo somente se você também tiver planejado como evitar nomes de saída duplicados de pastas aninhadas. Um código de saída diferente de zero é um aviso útil, mas não substitui a verificação de que cada PDF esperado existe e abre corretamente.

5. Evite conflitos de perfil e sobrescreva surpresas.

O LibreOffice precisa de permissão de escrita no perfil do usuário. Se uma janela interativa do LibreOffice já estiver em execução, uma conversão via linha de comando poderá reutilizar essa instância ou aguardar um perfil bloqueado. Feche outras janelas do LibreOffice antes de executar uma tarefa única. Para automação ou tarefas que precisam ser executadas separadamente, atribua um perfil de usuário dedicado à conversão usando a -env:UserInstallationopção de inicialização (bootstrap). A documentação do LibreOffice descreve a opção para selecionar um perfil não padrão.

soffice -env:UserInstallation=file:///tmp/lo-bulk-profile \
  --headless --convert-to pdf:writer_pdf_Export \
  --outdir "/srv/docs/converted" "/srv/docs/incoming/Annual Report.docx"

Use um diretório de perfil que possa ser gravado pela conta que executa a conversão. Não execute dois processos simultâneos do LibreOffice no mesmo perfil; use um perfil diferente para cada processo em execução. Mantenha a automação serial até que você tenha testado a versão instalada e a configuração de armazenamento.

Não execute uma conversão em uma pasta de produção sem antes definir como os PDFs existentes devem ser tratados. Faça backup ou mova os resultados anteriores, ou grave-os em um diretório novo com data e hora registradas. Uma exportação em lote não deve substituir silenciosamente um PDF assinado, aprovado ou previamente revisado.

6. Solucionar problemas comuns de falhas na conversão em lote

• Sem arquivos de saída: verifique o padrão glob de entrada ou o filtro do PowerShell, coloque entre aspas os caminhos que contêm espaços e confirme se o diretório de saída existe e é gravável. Execute o teste de arquivo único novamente para diferenciar um problema de caminho de um problema de lote.
• O comando foi concluído, mas alguns arquivos estão faltando: verifique a saída do terminal e o código de saída e compare a lista de origem com os PDFs criados. Um arquivo DOCX corrompido ou protegido por senha pode precisar ser reparado ou aberto manualmente antes da conversão.
• Se o LibreOffice travar ou informar que um perfil está bloqueado: feche qualquer processo interativo do LibreOffice ou tente novamente com um -env:UserInstallationperfil dedicado. Não exclua um diretório de perfil enquanto o LibreOffice estiver usando-o.
• As fontes ou a paginação podem diferir do Word: instale as fontes necessárias e compare um PDF representativo com o original. Para documentos em que a renderização exata no Word seja contratualmente importante, verifique o layout no aplicativo de autoria ou em um serviço de renderização aprovado.
• Os PDFs existentes permanecem inalterados: converta-os para uma pasta de saída vazia e confirme se o comando aponta para ela. Evite presumir que executar um lote novamente sempre sobrescreve um PDF anterior.

O LibreOffice também aceita opções de exportação para PDF após o nome do filtro, como intervalos de páginas ou configurações relacionadas à acessibilidade. Essas opções são úteis quando todos os arquivos devem ter o mesmo comportamento de exportação, mas teste-as em uma amostra antes de aplicá-las a um lote. Consulte os parâmetros oficiais da linha de comando para exportação de PDF .

7. Verifique o lote finalizado

Não julgue o sucesso apenas pelo fato de o comando ter retornado ao prompt. Compare o número de arquivos DOCX de origem com o número de PDFs na pasta de saída e, em seguida, inspecione alguns PDFs de diferentes partes do lote. Confirme se cada um abre, tem a quantidade de páginas esperada e inclui a última página, tabelas, imagens, cabeçalhos, rodapés e caracteres como letras acentuadas ou símbolos.

No Linux, você pode contar os arquivos de entrada e saída não recursivos com:

find "/srv/docs/incoming" -maxdepth 1 -type f -iname '*.docx' | wc -l
find "/srv/docs/converted" -maxdepth 1 -type f -iname '*.pdf' | wc -l

A contagem de correspondências é uma primeira verificação útil, mas não uma prova de que todos os arquivos estão corretos. Se as contagens forem diferentes, compare os nomes dos arquivos para identificar conversões ausentes. Para um fluxo de trabalho de alto volume ou regulamentado, registre cada caminho de origem, código de retorno, caminho de saída e resultado da validação, e mantenha os arquivos de origem até que os PDFs sejam revisados. O fluxo de trabalho de linha de comando do LibreOffice elimina a exportação manual repetitiva, enquanto uma etapa de validação separada detecta problemas de layout e de nível de arquivo que a automação não consegue identificar de forma confiável por si só.