{ TexDrop }

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.

  1. Abra ou crie um projeto.
  2. Escolha o arquivo principal, normalmente main.tex.
  3. No menu, selecione pdfLaTeX, XeLaTeX ou LuaLaTeX.
  4. Clique em Recompile.
  5. 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.