Cómo unir archivos PDF en la línea de comandos de Linux (pdfunite)

Puedes unir archivos PDF en la línea de comandos de Linux en segundos usando pdfunite del paquete poppler-utils. Es la forma más rápida de combinar PDF cuando trabajas en un terminal, ejecutas scripts por lotes en un servidor sin entorno gráfico o automatizas pipelines de documentos. Esta guía cubre pdfunite en profundidad y luego muestra cuándo recurrir a alternativas como qpdf (conserva marcadores e hipervínculos) y Ghostscript (comprime la salida). Si trabajas con PDF desde el terminal con frecuencia, estos son comandos esenciales de Linux que conviene tener en tu caja de herramientas.

¿Qué es poppler-utils?

Poppler-utils es un conjunto de utilidades de línea de comandos construidas sobre la biblioteca PDF poppler (un fork de xpdf). Viene con la mayoría de las distros de Linux e incluye seis herramientas:

Este artículo se centra en pdfunite para unir PDF, y cubre las demás herramientas donde ayudan en un flujo de trabajo de unión (como pdfinfo para la verificación).

Cómo instalar poppler-utils en Linux

Poppler-utils está en los repositorios oficiales de todas las distros principales. Instálalo con tu gestor de paquetes.

sudo apt install poppler-utils

sudo dnf install poppler-utils

sudo pacman -S poppler

sudo zypper install poppler-tools

sudo apk add poppler-utils

brew install poppler

pdfunite version 24.02.0
Copyright 2005-2024 The Poppler Developers - http://poppler.freedesktop.org
Copyright 1996-2011 Glyph & Cog, LLC

Cómo unir archivos PDF con pdfunite

Sintaxis básica

La sintaxis es simple: primero se listan los PDF de entrada y al final va el nombre del archivo de salida.

pdfunite file1.pdf file2.pdf file3.pdf output.pdf

Esto concatena file1.pdf, file2.pdf y file3.pdf en ese orden dentro de output.pdf.

Unir con comodines

Puedes usar la expansión de comodines del shell para unir todos los PDF de un directorio:

pdfunite *.pdf output.pdf

Unir desde una lista de archivos

Si tienes un archivo de texto con la lista de los PDF que quieres unir (un nombre de archivo por línea), ten en cuenta que pdfunite no admite leer desde stdin mediante un flag -. Usa sustitución de comandos en su lugar.

Enfoque simple (funciona si los nombres de archivo no tienen espacios):

pdfunite $(cat files.txt) output.pdf

Enfoque más seguro (maneja nombres de archivo con espacios):

mapfile -t files < files.txt
pdfunite "${files[@]}" output.pdf

El archivo files.txt debe contener una ruta de PDF por línea:

report-intro.pdf
report-chapter1.pdf
report-chapter2.pdf
report-appendix.pdf

Verificar la unión

Después de unir, comprueba el número de páginas para confirmar que están todas:

pdfinfo output.pdf | grep "^Pages:"

Compáralo con la suma de los recuentos de páginas individuales:

pdfinfo file1.pdf | grep "^Pages:"
pdfinfo file2.pdf | grep "^Pages:"
pdfinfo output.pdf | grep "^Pages:"   # debería ser igual a la suma

Comprueba también que el archivo no está vacío:

ls -lh output.pdf

Limitaciones de pdfunite (lo que debes saber)

pdfunite es rápido y simple, pero concatena los PDF a nivel de contenido de página. Esto significa:

• Se pierden los hipervínculos. Los enlaces internos del índice y las referencias cruzadas se rompen después de la unión.
• Se eliminan los marcadores/esquemas. Los esquemas del PDF (la navegación lateral en visores como Evince o Acrobat) desaparecen.
• Sin soporte de cifrado. No puedes unir PDF protegidos con contraseña directamente.
• Sin manipulación de páginas. No puedes rotar, reordenar ni extraer páginas concretas.
• Sin compresión. El archivo de salida puede ser más grande de lo esperado.

Para uniones simples (combinar facturas, páginas escaneadas o informes sin enlaces internos), pdfunite es la herramienta adecuada. Si necesitas que los marcadores o hipervínculos sobrevivan, cambia a qpdf.

Herramientas alternativas para unir PDF en Linux

Cuando pdfunite no es suficiente, estas tres herramientas cubren los huecos.

# Debian / Ubuntu
sudo apt install qpdf

# RHEL / Fedora
sudo dnf install qpdf

# Arch Linux
sudo pacman -S qpdf

qpdf --empty --pages file1.pdf file2.pdf file3.pdf -- output.pdf

# Páginas 1-5 de file1, todas las páginas de file2
qpdf --empty --pages file1.pdf 1-5 file2.pdf 1-z -- output.pdf

qpdf --decrypt --password=SECRET encrypted.pdf decrypted.pdf
pdfunite decrypted.pdf other.pdf merged.pdf

# Debian / Ubuntu
sudo apt install ghostscript

# RHEL / Fedora
sudo dnf install ghostscript

# Arch Linux
sudo pacman -S ghostscript

gs -dBATCH -dNOPAUSE -q -sDEVICE=pdfwrite \
   -dPDFSETTINGS=/ebook \
   -sOutputFile=merged.pdf file1.pdf file2.pdf

gs -sDEVICE=pdfwrite -dCompatibilityLevel=1.4 \
   -dPDFSETTINGS=/ebook -dNOPAUSE -dQUIET -dBATCH \
   -sOutputFile=compressed.pdf merged.pdf

# Con pip (cualquier distro)
pip install stapler

# Fedora
sudo dnf install pdf-stapler

stapler sel file1.pdf file2.pdf output.pdf

Tabla comparativa de herramientas

Flujos de trabajo reales y automatización

Script de unión por lotes con validación

Este script valida que todos los archivos de entrada existan, los une e informa del número de páginas:

#!/bin/bash
set -euo pipefail

OUTPUT="${1:-merged.pdf}"
shift

# Valida que todas las entradas existan
for f in "$@"; do
    [[ -f "$f" ]] || { echo "ERROR: File not found: $f" >&2; exit 1; }
done

pdfunite "$@" "$OUTPUT"
echo "Created: $OUTPUT ($(pdfinfo "$OUTPUT" | grep "^Pages:" | awk '{print $2}') pages)"

Uso:

chmod +x merge-pdfs.sh
./merge-pdfs.sh combined-report.pdf chapter1.pdf chapter2.pdf chapter3.pdf

Para flujos de trabajo de automatización más avanzados, puedes integrar el procesamiento de PDF en herramientas como n8n para pipelines de procesamiento de documentos.

Manejar PDF cifrados

pdfunite no puede procesar PDF protegidos con contraseña. Descífralos primero con qpdf:

# Descifrar
qpdf --decrypt --password=THEPASS protected.pdf unprotected.pdf

# Luego une como siempre
pdfunite unprotected.pdf other.pdf merged.pdf

# Elimina el archivo descifrado
rm unprotected.pdf

Verificar la unión

Verifica siempre después de unir, sobre todo en scripts:

# Comprueba que el total de páginas coincida con la suma de las entradas
EXPECTED=$(pdfinfo file1.pdf | grep "^Pages:" | awk '{sum += $2} END {print sum}')
EXPECTED=$((EXPECTED + $(pdfinfo file2.pdf | grep "^Pages:" | awk '{print $2}')))
ACTUAL=$(pdfinfo output.pdf | grep "^Pages:" | awk '{print $2}')

if [[ "$EXPECTED" -eq "$ACTUAL" ]]; then
    echo "OK: $ACTUAL pages"
else
    echo "MISMATCH: expected $EXPECTED, got $ACTUAL" >&2
    exit 1
fi

Mantener poppler-utils actualizado (seguridad)

# Debian / Ubuntu
sudo apt update && sudo apt upgrade poppler-utils

# RHEL / Fedora
sudo dnf upgrade poppler-utils

Solución de errores comunes

# Comprueba los permisos
ls -l file.pdf

# Solución: da al propietario lectura+escritura
chmod u+rw file.pdf

# Comprueba tu directorio de trabajo
pwd

# Lista los PDF del directorio actual
ls *.pdf

# Usa el autocompletado con tabulador para evitar erratas
pdfunite file1<TAB>

qpdf --check damaged.pdf
qpdf --qdf damaged.pdf repaired.pdf

gs -o repaired.pdf -sDEVICE=pdfwrite -dPDFSETTINGS=/prepress damaged.pdf

pdftk damaged.pdf output repaired.pdf

which pdfunite
# Sin salida = no instalado

# Comprueba la memoria disponible
free -h

# Monitoriza el uso de swap
swapon --show

gs -dBATCH -dNOPAUSE -q -sDEVICE=pdfwrite \
   -dPDFSETTINGS=/prepress \
   -sOutputFile=merged.pdf large1.pdf large2.pdf

Conclusión

Para unir archivos PDF en la línea de comandos de Linux, la herramienta que elijas depende de lo que necesites:

• pdfunite: opción por defecto para uniones simples. Rápida, diminuta, ya instalada en la mayoría de los sistemas.
• qpdf: úsala cuando haya marcadores, hipervínculos o PDF cifrados de por medio.
• Ghostscript: úsala cuando necesites comprimir la salida o unir archivos muy grandes.
• stapler: úsala cuando necesites manipulación de páginas al estilo pdftk.

Las herramientas hermanas de poppler son útiles en un flujo de trabajo de unión: pdfinfo para comprobar el número de páginas y el estado del cifrado antes de unir, pdfseparate para dividir un PDF (la operación inversa) y pdftotext para extraer texto para la verificación.

Si administras un VPS o un servidor sin entorno gráfico y procesas PDF con regularidad, mantén poppler-utils actualizado y considera securizar tu servidor Linux si maneja archivos de fuentes externas.

Preguntas frecuentes

qpdf --decrypt --password=THEPASS protected.pdf unprotected.pdf
pdfunite unprotected.pdf other.pdf merged.pdf

qpdf --empty --pages file1.pdf file2.pdf -- output.pdf

pdfunite intro.pdf chapter1.pdf chapter2.pdf appendix.pdf output.pdf