Errores frecuentes y cómo corregirlos
La mayoría de los problemas no detienen el documento: los comandos desconocidos se omiten y se enumeran en la pestaña Problemas, una fórmula que no se puede leer se muestra en rojo y se nombra ahí, y las imágenes o citas que faltan se marcan en su sitio; solo una imagen EPS detiene todo el documento.
Cómo se informa de los problemas
Una instalación de TeX se detiene en el primer error y te pregunta qué hacer. Scissor LaTeX sigue adelante: compone todo lo que puede del documento y enumera lo que no ha podido tratar en la pestaña Problemas, bajo la vista previa. Cada entrada indica la línea a la que se refiere, cuando se conoce, y al hacer clic en ella saltas allí.
Hay cuatro tipos de resultado:
| Qué ves | Qué significa | Dónde mirar |
|---|---|---|
| Un mensaje en la pestaña Problemas, el documento bien | Algo se ha omitido o se ha dejado fuera. | Las secciones de abajo. |
| Una fórmula mostrada como código fuente en rojo | Esa fórmula no se ha podido leer. | Fórmulas en rojo |
Un [key?] en rojo o un recuadro gris discontinuo | Falta una cita o una imagen. | Citas e imágenes que faltan |
| Ninguna página, un error arriba | Ha fallado todo el documento. | Cuando el documento entero no se compone |
"Skipped N unknown commands"
Es el mensaje que verás con más frecuencia, el equivalente al "Undefined control sequence" de LaTeX. Un comando que Scissor LaTeX no conoce se omite: su nombre desaparece y el texto entre sus llaves se queda.
Un comando desconocido: el nombre desaparece, el texto se queda
The value is \highlightvalue{44} and the unit is \unitname{kg}.Pestaña Problemas: Skipped 2 unknown commands: \highlightvalue, \unitname
Qué hacer:
- Revisa cómo está escrito.
\textbffunciona,\textboldno. - Si el comando viene de un paquete, busca el paquete en las páginas de paquetes. Algunos comandos tienen un sustituto sencillo.
- Si es un comando tuyo, comprueba que está definido con
\newcommandantes de usarlo (consulta Tus propios comandos).
Un entorno desconocido es distinto: se elimina sin avisar y su contenido se queda, sin ningún mensaje. Si un texto aparece sin formato, revisa el nombre del entorno.
"Package ... is not available here"
\usepackage nunca falla. Un paquete que Scissor LaTeX no conoce se señala en la pestaña Problemas y su formato no se aplica. El resto del documento se compone con normalidad, y los comandos del paquete que no se conocen se señalan como desconocidos.
Un paquete que no está disponible
\documentclass{article}
\usepackage{fancyboxes2}
\begin{document}
The document still typesets.
\end{document}Pestaña 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 en rojo
Cuando una fórmula contiene algo que el conversor matemático no puede leer, esa fórmula se muestra como código fuente en rojo. El resto del documento no se ve afectado. La pestaña Problemas nombra la fórmula, su línea y el motivo, como en "This formula could not be read: \symbf{v} (unknown command: \symbf)"; a partir de diez fórmulas, una línea más da el número de las restantes.
\symbf no está disponible, así que la fórmula sale en rojo
The vector $\symbf{v}$ is shown in red,
while $\boldsymbol{v}$ next to it works.En rojo: la fórmula no se puede leer, así que se muestra su código fuente.
Causas frecuentes y soluciones:
| Causa | Solución |
|---|---|
\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 | Reescribe la fórmula sin él. |
Un $ sin su pareja | Cierra la fórmula. Un $ sin cerrar no sale en rojo: convierte el resto de su párrafo en matemáticas en cursiva todo seguido, hasta la siguiente línea en blanco. |
Citas e imágenes que faltan
Una clave de cita que no está en ningún archivo .bib se imprime como [key?] en rojo, y la pestaña Problemas enumera las claves que faltan. Una imagen que falta se convierte en un recuadro gris discontinuo con el nombre del archivo.
Una imagen que no está en el proyecto
\begin{figure}[h]
\centering
\includegraphics[width=0.5\linewidth]{figures/plot.png}
\caption{A plot that has not been uploaded yet.}
\end{figure}
Pestaña Problemas: Images not in the project: figures/plot.png
Sube el archivo al proyecto con la misma ruta, o corrige la ruta. Sin extensión, se encuentran los archivos .png, .jpg, .jpeg y .svg; las figuras PDF y EPS también muestran el recuadro (consulta Figuras e imágenes). Para las citas, consulta Bibliografías y citas.
Otros mensajes
| Mensaje | Significado | Qué hacer |
|---|---|---|
| "N included files are not part of this conversion" | Se ha omitido \subfile, \import, \lstinputlisting, \inputminted o \includepdf. | Usa \input, o pega el contenido. |
| "File not found: ..." | Un \input o \include nombra un archivo que no está en el proyecto. | Revisa la ruta desde la carpeta superior del proyecto. |
| "N pictures of an unsupported kind are not included" | Se ha dejado fuera un entorno tikzcd, circuitikz, forest o picture. | Consulta Dibujos con TikZ. |
| "TikZ option '...' is not supported yet" | Una imagen usa una opción que el motor de dibujo no conoce. La imagen se dibuja sin ella. | Revisa la opción, o quítala. |
| "Layout in the style of ... Not official." | Una clase o un paquete de congreso ha cambiado a un diseño parecido. | Nada; es informativo. |
| "Macro expansion stopped at the safety limit" | Un comando se expande en sí mismo, o en una enorme cantidad de texto. | Busca un \newcommand que use su propio nombre. |
| "This formula could not be read: ..." | La fórmula se muestra en rojo; el motivo va entre paréntesis. | Consulta Fórmulas en rojo. |
| "References to labels that do not exist (shown as ??): ..." | Un \ref, \eqref, \pageref o \cref nombra una etiqueta que no está definida, o una que está en una fórmula en rojo. | Revisa cómo está escrita la etiqueta. |
| "Bibliography style ... is not available; using numbered references [1] instead" | \bibliographystyle nombra un estilo que no está en la lista, como alpha. | Elige un estilo de la lista, o quédate con las referencias numeradas. |
| "Skipped .bib entries: ..." | Estas entradas del archivo .bib no se han podido leer (falta una llave, una clave duplicada); las demás sí se usan. | Corrige la entrada en la línea indicada. |
Errores de LaTeX que aquí no verás
Algunos errores clásicos de LaTeX no detienen nada en Scissor LaTeX, por lo que es fácil pasarlos por alto:
| Error de LaTeX | Qué hace Scissor LaTeX |
|---|---|
"Missing $ inserted" con x_1 en el texto | Imprime x_1 literalmente. Pon las matemáticas entre $...$. |
| "Misplaced alignment tab character &" | Imprime & literalmente. Escribe \& para un et. |
| "Extra }, or forgotten $" | Ignora las llaves desequilibradas. |
| "\begin{itemize} ended by \end{document}" | Cierra el entorno por ti. |
| "Reference ... undefined" | Imprime ?? en negrita; la pestaña Problemas enumera las etiquetas que faltan. |
Texto que LaTeX rechazaría
Fish & chips cost 44 dollars, and x_1 is not a formula here.
Write Fish \& chips and $x_1$ instead.Estos documentos pueden seguir fallando en una instalación de TeX, así que corrígelos aunque la vista previa se vea bien.
Qué cambia respecto a una instalación de TeX
Para una lista de comprobación por síntomas, consulta Solución de problemas.
Preguntas y respuestas
¿Qué significa "Undefined control sequence"?
LaTeX no conoce un comando, normalmente por una errata o un paquete que falta. En Scissor LaTeX la misma situación aparece como "Skipped N unknown commands" en la pestaña Problemas, y el documento se compone igualmente.
¿Por qué mi fórmula sale en rojo?
La fórmula contiene un comando que el conversor matemático no conoce, como \symbf o \abs. La pestaña Problemas lo nombra. Sustituye ese comando; la tabla de esta página enumera los sustitutos habituales.
¿Por qué veo [key?] en mi documento?
La clave de cita no está en ningún archivo .bib del proyecto. Revisa cómo está escrita y que el archivo .bib se ha subido.
Scissor LaTeX compone cada ejemplo de esta página al generar el sitio. Última actualización: 2026-11-07.