Purplelink
← ModernTex

Guia

Escrever em português do Brasil com LaTeX no Mac: babel, acentos e ABNT

Por ·

Como montar um documento LaTeX em português do Brasil no Mac: escolher entre babel e polyglossia, carregar o T1, digitar acentos e aspas, ajustar a hifenização e compilar uma tese com a classe abntex2 e as citações da ABNT.

Este guia prepara um documento LaTeX em português do Brasil no Mac. Você escolhe uma distribuição TeX, instala os pacotes para o português, escreve um preâmbulo com babel, csquotes e biblatex e compila. Depois vêm uma variante com polyglossia e LuaLaTeX e a parte da ABNT, com a classe abntex2. Os exemplos são para copiar, e eu os compilei.

Em resumo

  1. Instale o MacTeX (tudo incluído) ou o TinyTeX (pequeno, os pacotes entram conforme a necessidade).

  2. Só com o TinyTeX: instale os pacotes do português com tlmgr install (passo 2).

  3. Carregue [T1]{fontenc}, lmodern e [brazilian]{babel} (passo 3).

  4. Digite acentos e aspas normalmente: o csquotes escolhe as aspas do idioma e o babel cuida da hifenização.

  5. Para uma tese na ABNT, use a classe abntex2 e o pacote abntex2cite (passo 5).

  6. Compile com latexmk -pdf main.tex, ou com latexmk -lualatex para o LuaLaTeX, ou em um editor como o ModernTex.

Passo 1: MacTeX ou TinyTeX

O MacTeX é a distribuição TeX Live completa para Mac e ocupa vários gigabytes. Tudo de que este guia precisa já está nele, inclusive a classe abntex2: você pode pular o passo 2.

O TinyTeX é bem menor e se instala na sua pasta pessoal (~/Library/TinyTeX), sem pedir senha de administrador. Em troca, faltam pacotes, que você adiciona com o tlmgr. Se o ModernTex não encontrar nenhuma distribuição na hora de compilar, ele oferece instalar o TinyTeX com um clique.

Passo 2: pacotes para o português (TinyTeX)

Abra o Terminal e execute o comando abaixo. Se o tlmgr não estiver no caminho de busca, chame-o por ~/Library/TinyTeX/bin/universal-darwin/tlmgr.

tlmgr install babel-portuges hyphen-portuguese csquotes biblatex biber lm microtype polyglossia fontspec luavlna abntex2 biblatex-abnt

Para que serve cada pacote:

Se o babel avisar depois que nenhum padrão de hifenização foi pré-carregado para o português, o formato da sua instalação foi montado sem eles: depois de tlmgr install hyphen-portuguese, reconstrua os formatos com fmtutil-sys --all. Isso aconteceu comigo ao instalar os pacotes em um TinyTeX recém-criado, e o aviso sumiu depois do fmtutil-sys --all. Com o MacTeX, esse caso não ocorre. Se um arquivo faltar mais tarde, tlmgr search --global --file nome.sty encontra o pacote.

Passo 3: o preâmbulo com babel

Salve isto como main.tex, em arquivo de texto UTF-8:

\documentclass[a4paper,12pt]{article}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage[brazilian]{babel}
\usepackage{microtype}
\usepackage[autostyle]{csquotes}
\usepackage[backend=biber,style=authoryear]{biblatex}
\addbibresource{referencias.bib}

\hyphenation{an-ti-cons-ti-tu-ci-o-nal-is-si-ma-men-te}

\title{Escrevendo em português do Brasil com LaTeX}
\author{João Antônio Conceição}
\date{\today}

\begin{document}
\maketitle

\section{Introdução}
Texto com acentos: ação, coração, órgão, você, também, avô, pêssego,
Brasília, açúcar, linguiça.
Ele disse: \enquote{isto é uma citação com \enquote{citação interna} dentro}.
Pronuncie devagar: anticonstitucionalissimamente.
Veja \textcite{silva2024} e \parencite{silva2024}.

\printbibliography[title={Referências}]
\end{document}

E, ao lado, o arquivo referencias.bib:

@book{silva2024,
  author    = {Silva, Maria Aparecida and Conceição, João Antônio},
  title     = {Escrevendo uma tese com {LaTeX}},
  date      = {2024},
  publisher = {Editora Exemplo},
  location  = {São Paulo},
}

O que cada linha faz:

Para uma tese, troque article por report ou book, ou pela classe da sua instituição.

Passo 4: pdfLaTeX ou LuaLaTeX, babel ou polyglossia

No Terminal, na pasta que contém main.tex:

latexmk -pdf main.tex

O latexmk roda o pdfLaTeX, o biber e o pdfLaTeX de novo quantas vezes for preciso. Compilei o preâmbulo acima em 29 de outubro de 2026 com o TinyTeX (TeX Live 2026) no macOS desta forma: o PDF sai com a data “29 de outubro de 2026”, as aspas “ ” com ‘ ’ dentro, os acentos corretos e a bibliografia com “Silva, Maria Aparecida e João Antônio Conceição (2024)”. Depois da primeira passada, o LaTeX avisa que a bibliografia ainda está vazia. Isso é normal, o biber a preenche na segunda.

Para o LuaLaTeX, há duas possibilidades. O babel também funciona com LuaLaTeX e XeLaTeX: basta carregar o fontspec no lugar de fontenc e lmodern e manter \usepackage[brazilian]{babel}. A outra solução é o polyglossia, que só funciona com XeLaTeX e LuaLaTeX. Para o português do Brasil, ele pede a variante:

\documentclass[a4paper,12pt]{article}
\usepackage{fontspec}
\usepackage{polyglossia}
\setmainlanguage[variant=brazilian]{portuguese}
\usepackage[autostyle]{csquotes}

\title{Escrevendo em português do Brasil com LaTeX}
\author{João Antônio Conceição}
\date{\today}

\begin{document}
\maketitle

\section{Introdução}
Texto com acentos: ação, coração, órgão, você, também, avô, pêssego,
Brasília, açúcar.
Ele disse: \enquote{isto é uma citação com \enquote{citação interna} dentro}.
\end{document}

Compile com:

latexmk -lualatex main.tex

Compilei os dois (polyglossia e babel com fontspec) da mesma forma, e a data, os acentos e as aspas saem como no primeiro exemplo. Aqui não há fontenc nem inputenc: o fontspec lê fontes OpenType, que já têm todas as letras acentuadas. A fonte padrão continua sendo a Latin Modern, e \setmainfont{...} escolhe outra. No ModernTex, abra a pasta, escolha o perfil de compilação desejado e compile. Para usar LuaLaTeX ou XeLaTeX em vez do pdfLaTeX, escreva na primeira linha % !TEX program = lualatex.

Qual escolher? Fique com o babel e o pdfLaTeX se você parte de um modelo de revista ou de instituição, porque a maioria das classes pressupõe o babel. Escolha o polyglossia, ou o babel com fontspec, se quiser fontes OpenType ou um texto que misture o português com outras escritas. Não carregue os dois juntos.

Passo 5: a ABNT e a classe abntex2

Teses, dissertações e trabalhos acadêmicos brasileiros costumam seguir as normas da ABNT. O projeto abnTeX2 (abntex.net.br) fornece a classe abntex2, que implementa essas normas, e o pacote abntex2cite, para citações e referências no padrão. No TeX Live, tudo isso vem em um único pacote chamado abntex2: a classe (abntex2.cls), abntex2cite.sty, abntex2abrev.sty e os estilos BibTeX abntex2-alf.bst (autor-data) e abntex2-num.bst (numérico). O MacTeX o inclui. No TinyTeX, tlmgr install abntex2, como no passo 2.

Um documento mínimo, que compilei com latexmk -pdf -bibtex main.tex. A classe carrega o babel sozinha, com a opção brazil:

\documentclass[12pt,a4paper,oneside,brazil]{abntex2}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{microtype}
\usepackage[alf]{abntex2cite}

\titulo{Escrevendo uma monografia com abnTeX2}
\autor{Maria Aparecida Silva}
\data{2026}

\begin{document}
\imprimirtitulo

\chapter{Introdução}
Citação no texto, entre parênteses: \cite{silva2024}.
Citação como parte da frase: \citeonline{silva2024}.

\begin{citacao}
Uma citação longa, com mais de três linhas, aparece em bloco, com recuo de 4~cm, fonte menor e espaçamento simples, como pede a ABNT NBR 10520.
Este parágrafo repete o texto para passar de três linhas e mostrar o recuo.
\end{citacao}

\bibliography{referencias}
\end{document}

E o referencias.bib, com os acentos escritos como comandos do LaTeX:

@book{silva2024,
  author    = {Silva, Maria Aparecida and Concei{\c{c}}{\~a}o, Jo{\~a}o Ant{\^o}nio},
  title     = {Escrevendo uma tese com {LaTeX}},
  year      = {2024},
  publisher = {Editora Exemplo},
  address   = {S{\~a}o Paulo},
}

O resultado, no PDF: \cite produz “(SILVA; CONCEIÇÃO, 2024)”, \citeonline produz “Silva e Conceição (2024)”, a citação longa fica em bloco com recuo, e a lista de “Referências” sai com os sobrenomes em maiúsculas, como pede a ABNT. Alguns detalhes:

A alternativa com biblatex e biber é o pacote biblatex-abnt, que aceita UTF-8 no .bib. Troque a linha do biblatex do passo 3 por \usepackage[backend=biber,style=abnt]{biblatex}. Em um teste com a mesma entrada, \cite saiu “(Silva; Conceição, 2024)”, e a referência saiu com “SILVA, Maria Aparecida; CONCEIÇÃO, João Antônio.” no começo. Isso não substitui a leitura da norma: confira com o manual da sua instituição qual sistema de citação e qual estilo de referência ela exige.

Onde coloco o modelo da minha instituição?

Coloque o arquivo de classe (.cls) e os arquivos de estilo (.sty) da instituição ao lado de main.tex, na mesma pasta: a compilação os encontra ali. Se o modelo pedir outros pacotes, instale-os com tlmgr install, e tlmgr search --global --file informa o nome do pacote.

Perguntas e respostas

Preciso carregar o inputenc para os acentos?

Não. Desde 2018, o LaTeX lê o código-fonte em UTF-8 por padrão. Basta que o arquivo esteja mesmo em UTF-8. Com o pdfLaTeX, carregue também \usepackage[T1]{fontenc}, para que as letras acentuadas sejam caracteres reais da fonte e as palavras acentuadas possam ser hifenizadas.

babel com brazilian ou com portuguese?

Para um texto do Brasil, use brazilian. A opção portuguese é a variante de Portugal, e alguns nomes automáticos diferem. No teste que fiz, \contentsname sai “Sumário” com brazilian e “Índice” com portuguese.

babel ou polyglossia para o português do Brasil?

O babel funciona com pdfLaTeX, XeLaTeX e LuaLaTeX. O polyglossia só funciona com XeLaTeX e LuaLaTeX e exige o fontspec. Se você compila com pdfLaTeX, ou se a sua instituição fornece uma classe que carrega o babel (como a abntex2), use o babel. Com XeLaTeX ou LuaLaTeX e fontes OpenType, os dois servem. Não carregue os dois juntos.

Por que o babel avisa que não há padrões de hifenização pré-carregados?

O formato do LaTeX da sua instalação foi montado sem os padrões do português. Instale hyphen-portuguese com tlmgr e reconstrua os formatos com fmtutil-sys --all. Com o MacTeX isso não acontece.

Por que o sobrenome aparece como CONCEIçãO nas referências da ABNT?

O estilo abntex2-alf passa o sobrenome para maiúsculas com o BibTeX, e o BibTeX não entende acentos em UTF-8. Escreva os acentos no arquivo .bib como comandos do LaTeX, por exemplo Concei{\c{c}}{\~a}o, ou use biblatex com style=abnt e biber, que aceitam UTF-8.

Como cito uma citação longa no formato da ABNT?

Na classe abntex2, o ambiente citacao compõe a citação em bloco, com recuo, fonte menor e espaçamento simples. O guia mostra um exemplo no documento do passo 5.

Compilar com o ModernTex

O ModernTex é um editor de LaTeX para Mac, com prévia do PDF sincronizada com o código-fonte, mensagens de erro em linguagem simples e verificações antes da submissão. Ele usa a sua instalação TeX, então tudo o que está acima vale também nele. A interface do app é em inglês. Sete dias grátis, depois US$ 19,99 uma única vez.