Instalación de escritorio

Lo primero que teclea casi todo el mundo tras instalar LaTeX es pdflatex --version. Y lo que responde no es «pdfLaTeX» sino pdfTeX 3.141592653-2.6-1.40.26 (TeX Live 2024). Que el número de versión sea π no es una broma —Knuth decidió que la versión de TeX convergiera hacia π— y pdflatex se anuncia como pdfTeX porque pdflatex es literalmente un enlace simbólico a pdftex. Esta página recorre la instalación en Windows, macOS y Linux, comprueba qué ha llegado realmente y después dedica tiempo al fallo con el que topa todo el mundo: que el comando no esté en el PATH. Las versiones actuales son TeX Live 2026 (1 de marzo de 2026) y MacTeX-2026.

Dos decisiones antes de lanzar el instalador

Solo hay dos: cuánto instalar (el esquema) y dónde ponerlo. Lo demás lo pregunta el instalador. El scheme-full por defecto ronda los 8 GB, el intermedio scheme-medium se queda algo por debajo de 2 GB y el pequeño scheme-basic supera por poco los 200 MB. Con una conexión estrecha, descargar y descomprimir una instalación completa puede llevar más de una hora sin problema. Qué contiene cada esquema —y si conviene instalar TeX Live o MiKTeX— se compara en la página «Distribuciones»; aquí nos centramos en el trabajo posterior a la decisión.

Instalar LaTeX en Windows

Windows es la más cómoda de las tres plataformas. Para TeX Live, descargue install-tl-windows.exe desde tug.org (unos 20 MB; el install-tl.zip idéntico también sirve) y ejecútelo. Es un instalador de red: una vez arrancado va trayendo la distribución de un espejo de CTAN. El destino por defecto es C:\texlive\2026 y el esquema se elige en la interfaz gráfica. Lo importante: en Windows el instalador configura PATH por usted —antepone la nueva entrada si ya hay otro TeX, y si no la añade al final—. Al acabar, abra un símbolo del sistema nuevo: una ventana que ya estaba abierta sigue sujetando el PATH antiguo.

REM Verify in a NEW Command Prompt after the installer finishes
where pdflatex
pdflatex --version
tlmgr --version

Si opta por MiKTeX, obtenga el Basic MiKTeX Installer (.exe) desde la página de descargas de miktex.org y ejecútelo. El asistente pregunta en esencia tres cosas: solo usuario actual (recomendado) o compartido para todos, el tamaño de papel y si instalar automáticamente los paquetes que falten (Always / Ask me first / Never). Una instalación compartida exige permisos de administrador y, como los paquetes traídos al vuelo acaban de todos modos en el árbol de cada usuario, «solo usuario actual» es la opción honesta en una máquina personal. Después, abra la MiKTeX Console y revise primero las actualizaciones. Para un despliegue desatendido en decenas de equipos existe una instalación silenciosa mediante miktexsetup.

Instalar LaTeX en macOS (MacTeX)

El estándar en macOS es MacTeX. Descargue MacTeX.pkg (unos 6,4 GB) desde tug.org, haga doble clic y siga las indicaciones: viene firmado y notarizado por Apple, así que Gatekeeper no lo detendrá. TeX se instala en /usr/local/texlive/2026, y las aplicaciones gráficas (TeXShop, BibDesk, LaTeXiT, TeX Live Utility) van a /Applications/TeX/. MacTeX-2026 exige macOS 11 (Big Sur) o posterior y funciona de forma nativa tanto en Intel como en Apple silicon; Catalina y anteriores ya no están soportados.

En cuanto al PATH, macOS es el más considerado de los tres. En lugar de meter el directorio de binarios (/usr/local/texlive/2026/bin/universal-darwin) directamente en el PATH, MacTeX apunta un enlace simbólico fijo, /Library/TeX/texbin, a los binarios de la versión activa. Seguida en este Mac, la cadena es /Library/TeX/texbin → Distributions/Programs/texbin → el bin de la cosecha actual, y un archivo colocado en /etc/paths.d añade /Library/TeX/texbin al PATH por defecto. El resultado es que una Terminal recién abierta simplemente funciona, y la versión del año próximo no exige editar ningún archivo de configuración. Para usarlo de inmediato en un shell ya abierto, reconstruya el PATH con path_helper.

# Refresh PATH in the current shell, then verify
eval "$(/usr/libexec/path_helper)"
which pdflatex      # -> /Library/TeX/texbin/pdflatex
pdflatex --version

Si no hacen falta las aplicaciones gráficas y basta con la línea de comandos, Homebrew es la vía rápida. mactex incluye las aplicaciones gráficas; mactex-no-gui es el mismo TeX Live completo sin ellas; basictex es una compilación mínima mucho más pequeña (sin interfaz gráfica ni Ghostscript) que se instala en /usr/local/texlive/2026basic. Como la mayoría edita de todos modos en VS Code o similares, en la práctica suele elegirse mactex-no-gui.

# Full TeX Live without the GUI apps (the usual Homebrew choice)
brew install --cask mactex-no-gui

# Or the full bundle with GUI apps
# brew install --cask mactex

# Or a small starter install
# brew install --cask basictex

Instalar en Linux / Unix

En Linux/Unix la vía directa es el instalador oficial install-tl. Traiga install-tl-unx.tar.gz, descomprímalo y ejecute el script de Perl incluido. El destino por defecto es /usr/local/texlive/2026, y escribir ahí exige sudo —o, si prefiere no usar sudo en absoluto, pulse D (directories) en el menú interactivo y mueva el destino bajo su directorio personal, por ejemplo ~/texlive/2026: el problema de permisos desaparece—. ¿Prefiere un instalador gráfico a la interfaz de texto? perl ./install-tl -gui arranca la versión Tcl/Tk, y --no-interaction instala la configuración por defecto sin preguntar nada.

# Download, unpack and run the official net installer
cd /tmp
curl -LO https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz
zcat < install-tl-unx.tar.gz | tar xf -
cd install-tl-*

sudo perl ./install-tl                 # interactive text installer
# sudo perl ./install-tl -gui          # Tcl/Tk installer instead
# sudo perl ./install-tl --scheme scheme-medium --no-interaction

En Unix el PATH lo configura usted; a diferencia de Windows, no hay paso automático. El directorio de binarios lleva el nombre de su CPU: /usr/local/texlive/2026/bin/x86_64-linux en Intel/AMD de 64 bits, o universal-darwin en macOS como en esta máquina. No hace falta recordar el nombre: el instalador imprime las líneas exactas que hay que añadir justo antes de terminar. Junto al PATH da también las rutas de las páginas man e info, así que copie las tres líneas en el archivo de inicio de su shell (~/.zshrc para zsh, ~/.profile o ~/.bashrc para la familia bash).

# Add to ~/.profile or ~/.bashrc; the folder name follows your CPU
export PATH="/usr/local/texlive/2026/bin/x86_64-linux:$PATH"
export MANPATH="/usr/local/texlive/2026/texmf-dist/doc/man:$MANPATH"
export INFOPATH="/usr/local/texlive/2026/texmf-dist/doc/info:$INFOPATH"

# Then reload and check
. ~/.profile
which pdflatex

Cuando instalar por red no es realista —conexión estrecha, decenas de equipos de laboratorio o directamente sin internet—, se puede instalar desde la imagen ISO anual. Traiga la ISO de unos 6 GB de un espejo de CTAN, móntela y ejecute el install-tl que contiene (install-tl-windows.bat en Windows); toda la distribución entra sin red. Una salvedad: el contenido de la ISO nunca se actualiza tras su publicación, así que una vez instalado recuerde reapuntar las actualizaciones al repositorio en línea tlnet.

# Offline install from the yearly ISO image (Linux/Unix)
sudo mount -t iso9660 -o ro,loop,noauto texlive.iso /mnt
cd /mnt && sudo perl install-tl

# Afterwards, send updates back to the online repository
tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet

Confirmar que ha llegado: which pdflatex y pdflatex --version

La comprobación va en tres pasos y responde a qué binario se ejecuta, de qué año es y a qué árbol pertenece. which pdflatex (where pdflatex en Windows) indica el ejecutable que realmente se lanzará, y pdflatex --version se presenta incluyendo el año, como en pdfTeX 3.141592653-2.6-1.40.26 (TeX Live 2024). Pero la ubicación del ejecutable no basta. El comando decisivo es kpsewhich -var-value=SELFAUTOPARENT, que devuelve la raíz del árbol de TeX que ese binario usa de verdad: en este Mac, /usr/local/texlive/2024. Cuando el binario y su árbol se han separado, esta única línea lo destapa antes que nada.

# 1. which binary runs, 2. which release it is, 3. which tree it uses
which pdflatex
pdflatex --version
kpsewhich -var-value=SELFAUTOPARENT

# On Windows, replace the first line with:
# where pdflatex

Por último, demuestre una vez que compone de verdad: escriba un .tex diminuto, compílelo y, si aparece un PDF, la instalación está lista. Si este paso falla, la causa casi nunca es el PATH: mire más bien si el directorio de trabajo admite escritura, o si el nombre del archivo lleva caracteres fuera de ASCII.

printf '\\documentclass{article}\\begin{document}Hello, \\LaTeX!\\end{document}' > hello.tex
pdflatex hello.tex
# -> produces hello.pdf

Cuando no se encuentra el comando latex o se ejecuta el año equivocado

Si which o where no devuelve nada, el PATH no está configurado. Si devuelve algo pero el comportamiento es raro, lea con atención la ruta que ha impreso. Lo que se describe como «la ruta de LaTeX no funciona» es en la práctica una de estas tres cosas. Primera, no se ha vuelto a abrir la terminal: el ajuste cambió, pero ese shell sigue sujetando el PATH antiguo. Segunda, el PATH sigue apuntando al árbol de un año antiguo: el año pasado escribió /usr/local/texlive/2025/bin/... en ~/.zshrc, este año instaló la nueva versión y esa línea sigue ahí. Si /usr/local/texlive/2025 ya se borró, aparece command not found; si no se borró, la versión del año pasado sigue ejecutándose en silencio. Tercera, dos instalaciones de TeX se pelean por ir primero.

El tercero es el más molesto: pdflatex de TeX Live, bibtex de un paquete del sistema, tlmgr de un MacTeX viejo. Uno cree estar procesando un solo manuscrito; las herramientas están mirando cada una a un árbol distinto. En vez de teclear which una y otra vez, ejecute tlmgr conf una sola vez. El comando recorre el PATH y lista la ubicación resuelta de pdftex, xetex, luatex, dvips, dvipdfmx, kpsewhich, fmtutil, updmap y tlmgr, y a continuación imprime también los archivos de configuración y los mapas de fuentes activos. Si aunque sea una línea apunta a un árbol distinto del resto, ahí está la causa.

# One command that resolves every core tool at once
tlmgr conf

# Look for a line whose path differs from the others, e.g.
#   pdftex:    /usr/local/texlive/2026/bin/universal-darwin/pdftex
#   bibtex:    /usr/bin/bibtex          <- a different install!

# The manual equivalent, if tlmgr itself is the thing you distrust
which pdflatex
which lualatex
which tlmgr

• Tras editar un archivo de inicio, abra una terminal nueva o vuelva a cargarlo. Una terminal que siguió abierta conserva el PATH antiguo.
• Antes de instalar en una máquina que ya tiene TeX, anote lo que dice which pdflatex. Después sabrá qué cambió.
• Que un directorio aparezca dos veces en el PATH es inofensivo. Lo que hace daño es una línea que apunta a otro árbol y va delante.
• Si usa el TeX Live oficial, no añada después los texlive-* de apt: acabaría con dos árboles compitiendo por la cabeza del PATH.
• Si usa MiKTeX, mantenga actualizaciones y adiciones de paquetes dentro de la MiKTeX Console. tlmgr no gestiona MiKTeX.