Como compilar LaTeX no Windows, Linux e Overleaf
English: Read this tutorial in English.
Compilar LaTeX significa transformar arquivos .tex em um documento final, geralmente PDF. Você pode trabalhar inteiramente no Overleaf ou instalar uma distribuição local no Windows ou Linux. A melhor escolha depende da conexão, do tamanho do projeto e do nível de controle desejado.
Opção 1: compilar no Overleaf
O Overleaf reúne editor, distribuição LaTeX e visualizador de PDF no navegador.
- Abra ou crie um projeto.
- Escolha o arquivo principal, normalmente
main.tex. - No menu, selecione pdfLaTeX, XeLaTeX ou LuaLaTeX.
- Clique em Recompile.
- Leia o primeiro erro do log caso o PDF não seja gerado.
Essa opção é excelente para iniciantes e colaboração. Projetos muito grandes, dependências especiais ou trabalho sem internet podem favorecer uma instalação local.
Opção 2: compilar no Windows
No Windows, as distribuições mais conhecidas são MiKTeX e TeX Live. Instale apenas a partir dos sites oficiais e mantenha os pacotes atualizados.
Depois da instalação, abra o terminal na pasta do projeto e execute:
pdflatex main.tex
Para projetos com fontes do sistema:
xelatex main.tex
lualatex main.tex
Editores como TeXstudio e Visual Studio Code com LaTeX Workshop podem executar esses comandos por botões e atalhos.
Opção 3: compilar no Linux
Em distribuições baseadas em Debian ou Ubuntu, o TeX Live pode ser instalado pelo gerenciador de pacotes do sistema. Escolha uma coleção compatível com seu espaço em disco e necessidades.
sudo apt update
sudo apt install texlive-latex-extra latexmk biber
Em Fedora, Arch e outras distribuições, os nomes dos pacotes variam. Consulte a documentação oficial da distribuição.
Automatize com latexmk
latexmk identifica quantas compilações são necessárias e chama ferramentas auxiliares:
latexmk -pdf main.tex
Para limpar arquivos temporários:
latexmk -c
Não use comandos de limpeza em pastas que contenham arquivos importantes sem conferir o que será removido.
Bibliografia e referências cruzadas
Alguns projetos precisam de várias passagens. Com BibLaTeX e Biber, a sequência manual costuma ser:
pdflatex main.tex
biber main
pdflatex main.tex
pdflatex main.tex
O Overleaf e o latexmk normalmente automatizam esse processo.
Qual compilador escolher?
- pdfLaTeX: rápido e compatível com muitos templates tradicionais.
- XeLaTeX: simples para fontes do sistema e diversos alfabetos.
- LuaLaTeX: moderno, programável e adequado a projetos complexos.
Veja os detalhes em pdfLaTeX, XeLaTeX ou LuaLaTeX: qual escolher?.
Problemas frequentes
Comando não encontrado
Confirme se a distribuição foi instalada e se o terminal reconhece o caminho dos executáveis. Reinicie o editor após a instalação.
Pacote ausente
Instale o pacote pelo gerenciador da distribuição. No Overleaf, verifique se o pacote faz parte da versão TeX Live selecionada.
Arquivo não encontrado
Execute o comando na pasta do projeto e use nomes de arquivos sem espaços ou caracteres problemáticos.
PDF desatualizado
Limpe arquivos auxiliares e recompile. Leia o log desde o primeiro erro, pois mensagens posteriores podem ser apenas consequências.
Comparação rápida
- Overleaf: configuração mínima, colaboração e acesso em qualquer computador.
- Windows local: bom suporte de editores e trabalho offline.
- Linux local: automação, integração com scripts e controle do ambiente.
Depois de configurar seu ambiente, teste-o com um dos templates LaTeX da TexDrop e registre o compilador recomendado no arquivo de instruções do projeto.