> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/es/preguntas-y-respuestas/83-what-does-pdfendlink-ended-up-in-different-nesting-level-than-pdfstartlink-mean.md).

# ¿Qué significa "\pdfendlink ended up in different nesting level than \pdfstartlink"?

## Algo de contexto sobre este error (advertencia)

Como sugieren sus nombres, los `\pdfstartlink` y `\pdfendlink` comandos se utilizan para crear hipervínculos dentro de archivos PDF generados por TeX/LaTeX —por ejemplo, enlaces a distintas páginas dentro del archivo PDF o enlaces a sitios web. Estos comandos son las llamadas *primitivas*: comandos de bajo nivel integrados en los motores TeX: no son macros. Como consecuencia, la mayoría de los usuarios no se encuentran con ellas directamente, sino que las usan indirectamente a través de macros (comandos) proporcionadas por paquetes como `hyperref`.

En el momento de escribir esto (diciembre de 2022) `\pdfstartlink` y `\pdfendlink` solo son compatibles con dos motores TeX: pdfTeX y LuaTeX (y LuaHBTeX). Históricamente, tanto pdfTeX como LuaTeX generaban un *error* mensaje del tipo

```latex
\pdfendlink terminó en un nivel de anidamiento diferente al de \pdfstartlink
```

en respuesta a problemas de bajo nivel relacionados con la profundidad del anidamiento de cajas. Ten en cuenta que el texto de este mensaje se origina en lo más profundo del software del motor TeX; no lo produce ningún paquete de LaTeX ni, por supuesto, Overleaf.

A partir de TeX Live 2021, pdfTeX y LuaTeX divergieron en su manejo del problema subyacente (anidamiento de cajas) y ahora presentan un comportamiento diferente:

* pdfTeX ahora emite ese mensaje como una **advertencia**, ya no provoca un error y la compilación *no* se interrumpe;
* LuaTeX (LuaHBTeX) sigue tratando este problema como un **error fatal**, lo que hace que la compilación se interrumpa; la redacción de ese mensaje de error difiere ligeramente de la mostrada arriba.

Los lectores que deseen profundizar más en la causa subyacente de este error pueden:

* abrir este proyecto de Overleaf

  que compila correctamente con pdfLaTeX, pero provoca el error con LuaLaTeX;
* consultar una [discusión técnica en profundidad en GitHub](https://github.com/latex3/latex2e/issues/94), llevada a cabo entre expertos destacados en TeX y LaTeX.

## A nivel práctico, ¿qué lo causa?

A nivel de usuario, esta advertencia (o error) puede desencadenarse al usar el `hyperref` paquete y un hipervínculo—como una cita, una URL o una referencia cruzada— se divide entre dos páginas o dos columnas en un documento de varias columnas; es decir, el enlace comienza cerca del final de una página (o columna) y termina en la página (o columna) siguiente.

Como se ha comentado, pdfTeX (pdfLaTeX) con TeX Live 2021 o posterior ya no genera un error, pero, en el momento de escribir esto (diciembre de 2022), LuaLaTeX sigue haciéndolo. Si estás usando LuaLaTeX, una solución temporal mientras trabajas en tu documento es desactivar los hipervínculos escribiendo

```latex
\hypersetup{draft}
```

justo antes de tu

```latex
\begin{document}
```

Aunque esto impide que los hipervínculos aparezcan en tu documento, evita el error mientras escribes y, cuando estés listo para compilar el documento final, puedes comentar o eliminar `\hypersetup{draft}`. Si tienes la mala suerte de seguir encontrándote con este problema en la fase de compilación final, vuelve a activar el `draft` y luego revisa tu PDF para encontrar al posible culpable (citas, referencias cruzadas, flotantes en la parte superior de las páginas...), de modo que puedas, *con suerte*..., encontrar una forma de editar/reformular tu texto para evitar el problema.

## Más información

Si te encuentras con este problema como un error fatal, puede requerir cierto trabajo detectivesco para rastrear la causa exacta. tex.stackexchange tiene varias discusiones, pero ten en cuenta que algunas de estas páginas son anteriores a la rebaja de pdfTeX del error a una advertencia:

* <https://tex.stackexchange.com/questions/1522/pdfendlink-ended-up-in-different-nesting-level-than-pdfstartlink>
* <https://tex.stackexchange.com/questions/63819/mysterious-error-pdfendlink-ended-up-in-different-nesting-level-than-pdfstart>
* <https://tex.stackexchange.com/questions/249579/pdfendlink-ended-up-in-different-nesting-level-than-pdfstartlink-error-with/>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/es/preguntas-y-respuestas/83-what-does-pdfendlink-ended-up-in-different-nesting-level-than-pdfstartlink-mean.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
