Erros comuns e como corrigi-los
A maioria dos problemas não trava o documento: comandos desconhecidos são ignorados e listados na aba Problemas, uma fórmula que não pode ser lida aparece em vermelho e é citada ali, e imagens ou citações que faltam são marcadas no lugar; só uma imagem EPS trava o documento inteiro.
Como os problemas são indicados
Uma instalação do TeX para no primeiro erro e pergunta o que fazer. O Scissor LaTeX continua: compõe o máximo possível do documento e lista o que não conseguiu tratar na aba Problemas, abaixo da prévia. Cada item traz a linha a que se refere, quando ela é conhecida, e clicar nele leva até lá.
Há quatro tipos de resultado:
| O que você vê | O que significa | Onde procurar |
|---|---|---|
| Uma mensagem na aba Problemas, documento normal | Algo foi ignorado ou deixado de fora. | As seções abaixo. |
| Uma fórmula mostrada como código-fonte vermelho | Essa fórmula não pôde ser lida. | Fórmulas vermelhas |
Um [key?] vermelho ou uma caixa cinza tracejada | Falta uma citação ou uma imagem. | Citações e imagens que faltam |
| Nenhuma página, um erro no topo | O documento inteiro falhou. | Quando o documento inteiro não é composto |
"Skipped N unknown commands"
Esta é a mensagem que você vai ver com mais frequência, e o equivalente ao "Undefined control sequence" do LaTeX. Um comando que o Scissor LaTeX não conhece é ignorado: o nome dele some, e o texto entre as chaves fica.
Um comando desconhecido: o nome some, o texto fica
The value is \highlightvalue{44} and the unit is \unitname{kg}.Aba Problemas: Skipped 2 unknown commands: \highlightvalue, \unitname
O que fazer:
- Confira a grafia.
\textbffunciona,\textboldnão. - Se o comando vem de um pacote, procure o pacote nas páginas de pacotes. Alguns comandos têm um substituto simples.
- Se é um comando seu, confira se ele está definido com
\newcommandantes de ser usado (veja Seus próprios comandos).
Um ambiente desconhecido é diferente: ele é removido sem aviso e o conteúdo dele fica, sem mensagem. Se um texto parece sem formatação, confira o nome do ambiente.
"Package ... is not available here"
\usepackage nunca falha. Um pacote que o Scissor LaTeX não conhece é anotado na aba Problemas, e a formatação dele não é aplicada. O resto do documento é composto normalmente, e os comandos do pacote que não são conhecidos são indicados como desconhecidos.
Um pacote que não está disponível
\documentclass{article}
\usepackage{fancyboxes2}
\begin{document}
The document still typesets.
\end{document}Aba Problemas: Package fancyboxes2 isn't supported in the preview, so its formatting is not applied. If it is your own package, add fancyboxes2.sty to the project.
Fórmulas vermelhas
Quando uma fórmula contém algo que o conversor de matemática não consegue ler, essa fórmula aparece como código-fonte vermelho. O resto do documento não é afetado. A aba Problemas cita a fórmula, a linha e o motivo, como em "This formula could not be read: \symbf{v} (unknown command: \symbf)"; depois de dez fórmulas, uma linha a mais dá o número das restantes.
\symbf não está disponível, então a fórmula fica vermelha
The vector $\symbf{v}$ is shown in red,
while $\boldsymbol{v}$ next to it works.Em vermelho: a fórmula não pode ser lida, então o código-fonte dela aparece no lugar.
Causas comuns e correções:
| Causa | Correção |
|---|---|
\abs{x}, \norm{x}, \dv{f}{x} (physics) | \left\lvert x \right\rvert, \left\lVert x \right\rVert, \frac{df}{dx} |
\SI{44}{\kilo\gram} (siunitx) | 44\,\mathrm{kg} |
\sideset | Reescreva a fórmula sem ele. |
Um $ sem o par | Feche a fórmula. Um $ não fechado não fica vermelho: ele transforma o resto do parágrafo em matemática itálica toda emendada, até a próxima linha em branco. |
Citações e imagens que faltam
Uma chave de citação que não está em nenhum arquivo .bib é impressa como um [key?] vermelho, e a aba Problemas lista as chaves que faltam. Uma imagem que falta vira uma caixa cinza tracejada com o nome do arquivo.
Uma imagem que não está no projeto
\begin{figure}[h]
\centering
\includegraphics[width=0.5\linewidth]{figures/plot.png}
\caption{A plot that has not been uploaded yet.}
\end{figure}
Aba Problemas: Images not in the project: figures/plot.png
Envie o arquivo para o projeto com o mesmo caminho, ou corrija o caminho. Sem extensão, são encontrados arquivos .png, .jpg, .jpeg e .svg; figuras em PDF e EPS também mostram a caixa (veja Figuras e imagens). Para citações, veja Bibliografias e citações.
Outras mensagens
| Mensagem | Significado | O que fazer |
|---|---|---|
| "N included files are not part of this conversion" | \subfile, \import, \lstinputlisting, \inputminted ou \includepdf foi ignorado. | Use \input ou cole o conteúdo. |
| "File not found: ..." | Um \input ou \include indica um arquivo que não está no projeto. | Confira o caminho a partir da pasta principal do projeto. |
| "N pictures of an unsupported kind are not included" | Um ambiente tikzcd, circuitikz, forest ou picture ficou de fora. | Veja Desenhos com TikZ. |
| "TikZ option '...' is not supported yet" | Um desenho usa uma opção que o motor de desenho não conhece. O desenho é feito sem ela. | Confira a opção ou tire-a. |
| "Layout in the style of ... Not official." | Uma classe ou pacote de conferência trocou para um layout parecido. | Nada; é só uma informação. |
| "Macro expansion stopped at the safety limit" | Um comando se expande nele mesmo, ou em uma quantidade enorme de texto. | Procure um \newcommand que usa o próprio nome. |
| "This formula could not be read: ..." | A fórmula aparece em vermelho; o motivo está entre parênteses. | Veja Fórmulas vermelhas. |
| "References to labels that do not exist (shown as ??): ..." | Um \ref, \eqref, \pageref ou \cref indica um rótulo que não está definido, ou um que está em uma fórmula vermelha. | Confira a grafia do rótulo. |
| "Bibliography style ... is not available; using numbered references [1] instead" | \bibliographystyle indica um estilo que não está na lista, como alpha. | Escolha um estilo da lista, ou fique com as referências numeradas. |
| "Skipped .bib entries: ..." | Essas entradas do arquivo .bib não puderam ser lidas (uma chave faltando, uma chave duplicada); as outras são usadas. | Corrija a entrada na linha indicada. |
Erros de LaTeX que você não vai ver aqui
Alguns erros clássicos do LaTeX não travam nada no Scissor LaTeX, o que os torna fáceis de passar despercebidos:
| Erro do LaTeX | O que o Scissor LaTeX faz |
|---|---|
"Missing $ inserted" para x_1 no texto | Imprime x_1 literalmente. Coloque a matemática entre $...$. |
| "Misplaced alignment tab character &" | Imprime & literalmente. Escreva \& para um "e" comercial. |
| "Extra }, or forgotten $" | Ignora chaves desbalanceadas. |
| "\begin{itemize} ended by \end{document}" | Fecha o ambiente por você. |
| "Reference ... undefined" | Imprime ?? em negrito; a aba Problemas lista os rótulos que faltam. |
Texto que o LaTeX rejeitaria
Fish & chips cost 44 dollars, and x_1 is not a formula here.
Write Fish \& chips and $x_1$ instead.Esses documentos ainda podem falhar em uma instalação do TeX, então corrija-os mesmo que a prévia pareça boa.
O que muda em relação a uma instalação do TeX
Para uma lista de verificação por sintoma, veja Solução de problemas.
Perguntas e respostas
O que significa "Undefined control sequence"?
O LaTeX não conhece um comando, normalmente por um erro de digitação ou um pacote que falta. No Scissor LaTeX a mesma situação aparece como "Skipped N unknown commands" na aba Problemas, e o documento é composto mesmo assim.
Por que minha fórmula está vermelha?
A fórmula contém um comando que o conversor de matemática não conhece, como \symbf ou \abs. A aba Problemas o indica. Troque esse comando; a tabela desta página lista os substitutos mais comuns.
Por que aparece [key?] no meu documento?
A chave de citação não está em nenhum arquivo .bib do projeto. Confira a grafia e se o arquivo .bib foi enviado.
Cada exemplo desta página é composto pelo Scissor LaTeX quando o site é gerado. Última atualização: 2026-11-07.