# Notas al pie y notas al final

- Human documentation: [https://docs.univer.ai/es-ES/guides/docs/features/footnotes](https://docs.univer.ai/es-ES/guides/docs/features/footnotes)

- Agent Markdown: [https://docs.univer.ai/es-ES/guides/docs/features/footnotes.md](https://docs.univer.ai/es-ES/guides/docs/features/footnotes.md)

- Requested language: `es-ES`

- Content language: `es-ES`

- Documentation version: `1.2.0`

- Source: [docs/features/footnotes.es-ES.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/docs/features/footnotes.es-ES.mdx)

---

#### Package metadata

```json
{
  "preset": [
    {
      "client": "@univerjs/preset-docs-advanced",
      "locale": "@univerjs/preset-docs-advanced/locales/es-ES",
      "style": "@univerjs/preset-docs-advanced/lib/index.css"
    }
  ],
  "plugins": [
    {
      "client": "@univerjs-pro/docs-reference",
      "facade": "@univerjs-pro/docs-reference/facade"
    },
    {
      "client": "@univerjs-pro/docs-reference-ui",
      "locale": "@univerjs-pro/docs-reference-ui/locale/es-ES",
      "style": "@univerjs-pro/docs-reference-ui/lib/index.css"
    }
  ],
  "license": true,
  "server": false
}
```

Añade notas a documentos tradicionales paginados. Las notas al pie se colocan en la página de su referencia y las notas al final siguen la configuración del documento. Esta API no admite documentos modernos.

## Instalación

Añade estos plugins a un editor Docs con la licencia configurada. Carga los estilos y los recursos del idioma del editor.

`UniverDocsAdvancedPreset` ya incluye ambos plugins. Si utilizas ese preset, no los registres de nuevo.

#### npm

```bash
npm install @univerjs-pro/docs-reference @univerjs-pro/docs-reference-ui
```

#### pnpm

```bash
pnpm add @univerjs-pro/docs-reference @univerjs-pro/docs-reference-ui
```

#### yarn

```bash
yarn add @univerjs-pro/docs-reference @univerjs-pro/docs-reference-ui
```

#### bun

```bash
bun add @univerjs-pro/docs-reference @univerjs-pro/docs-reference-ui
```

```ts
import { UniverDocsReferencePlugin } from '@univerjs-pro/docs-reference'
import { UniverDocsReferenceUIPlugin } from '@univerjs-pro/docs-reference-ui'
import ReferenceLocale from '@univerjs-pro/docs-reference-ui/locale/es-ES'
import { LocaleType } from '@univerjs/core'

import '@univerjs-pro/docs-reference/facade'
import '@univerjs-pro/docs-reference-ui/lib/index.css'

univerAPI.loadLocales(LocaleType.ES_ES, ReferenceLocale)
univer.registerPlugin(UniverDocsReferencePlugin)
univer.registerPlugin(UniverDocsReferenceUIPlugin)
```

## Insertar y gestionar notas

```ts
const document = univerAPI.getActiveDocument()
if (document) {
  const noteId = document.insertFootnote(0)
  if (noteId) console.log(document.getParagraphs(noteId))
  console.log(document.getFootnotes(), document.getEndnotes())
}
```

El desplazamiento es una posición UTF-16 del cuerpo principal, incluidos los tokens estructurales. La inserción devuelve `null` si la posición o el contenido no son válidos, faltan permisos o el documento es moderno. Si tiene éxito, devuelve un ID estable. La referencia y el contenido forman parte de la misma mutación de deshacer y colaboración.

Lee las notas con `getFootnotes()` / `getEndnotes()` y elimínalas con `deleteFootnote(noteId)` / `deleteEndnote(noteId)`. `setFootnoteSettings()` y `setEndnoteSettings()` configuran la numeración y ubicación; `null` restablece la configuración explícita. Conserva el ID devuelto para acceder al contenido: el número visible puede cambiar tras paginar de nuevo.