Cómo agregar marcadores y esquemas PDF en C# usando IronPDF

Cómo añadir marcadores y esquemas PDF en C# con IronPDF

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF permite añadir marcadores (esquemas) a documentos PDF en C#, creando ayudas de navegación similares a un índice. Añade marcadores de una o varias capas para mejorar la usabilidad del documento y ayudar a los usuarios a saltar rápidamente a las secciones clave. Esta función funciona perfectamente en los entornos Windows, Linux y macOS. En el contexto fiscal español, los marcadores PDF son una herramienta valiosa para los expedientes de cumplimiento que se presentan ante la AEAT en inspecciones tributarias, los dossiers de operaciones del SII organizados por trimestre fiscal, y los portfolios de facturas Facturae con múltiples secciones que los auditores deben revisar de forma no lineal. Un marcador bien estructurado en un expediente de IVA puede marcar la diferencia entre una revisión rápida por el inspector y horas de búsqueda manual.

Inicio rápido: Cómo agregar marcadores a su PDF en C#

Empiece a utilizar IronPDF rápidamente añadiendo marcadores a sus documentos PDF. Esta guía muestra cómo cargar un PDF existente, añadir marcadores para la navegación y guardar el documento actualizado. Perfecto para desarrolladores que buscan mejorar la funcionalidad de PDF en sus proyectos de C#.

  1. Instala IronPDF con el Administrador de Paquetes NuGet

    PM > Install-Package IronPdf
  2. Copie y ejecute este fragmento de código.

    var pdf = new IronPdf.PdfDocument("example.pdf");
    pdf.Bookmarks.AddBookMarkAtEnd("Chapter 1", 1);
    pdf.SaveAs("bookmarked.pdf");
  3. Despliegue para probar en su entorno real

    Comienza a usar IronPDF en tu proyecto hoy mismo con una prueba gratuita

    arrow pointer

¿Cómo trabajar con marcadores PDF en C#?

En Adobe Acrobat Reader, los esquemas (también conocidos como marcadores) se muestran en la barra lateral izquierda, proporcionando una forma conveniente de saltar a secciones clave del documento. Los marcadores funcionan como un índice interactivo que permite a los lectores navegar por documentos complejos de forma eficaz.

Con IronPDF, puede importar documentos PDF y realizar diversas operaciones en los esquemas existentes, como añadir, reordenar, editar propiedades y eliminar marcadores. Esto le da un control total sobre la organización y estructura de sus archivos PDF, de forma similar a como puede fusionar o dividir PDFs para la gestión de documentos.

ConsejosTodos los índices de página siguen una indexación basada en cero.

¿Cómo añado marcadores de una sola capa?

Añadir un marcador en IronPDF es muy sencillo. Utilice el método AddBookmarkAtEnd, especificando el nombre del marcador y el índice de página correspondiente. Esta funcionalidad se integra bien con otras operaciones de PDF como añadir encabezados y pies de página o establecer márgenes personalizados para crear documentos profesionales. Ejemplo:

:path=/static-assets/pdf/content-code-examples/how-to/bookmarks-single-layer-bookmark.cs
using IronPdf;

// Create a new PDF or edit an existing document.
PdfDocument pdf = PdfDocument.FromFile("existing.pdf");

// Add a bookmark
pdf.Bookmarks.AddBookMarkAtEnd("NameOfBookmark", 0);

// Add a sub-bookmark
pdf.Bookmarks.AddBookMarkAtEnd("NameOfSubBookmark", 1);

pdf.SaveAs("singleLayerBookmarks.pdf");
Imports IronPdf

' Create a new PDF or edit an existing document.
Private pdf As PdfDocument = PdfDocument.FromFile("existing.pdf")

' Add a bookmark
pdf.Bookmarks.AddBookMarkAtEnd("NameOfBookmark", 0)

' Add a sub-bookmark
pdf.Bookmarks.AddBookMarkAtEnd("NameOfSubBookmark", 1)

pdf.SaveAs("singleLayerBookmarks.pdf")
$vbLabelText   $csharpLabel

El método AddBookMarkAtEnd añade marcadores al final de la lista de marcadores existente. Para tener más control sobre la ubicación de los marcadores, use AddBookMarkAtStart para insertar marcadores al principio de la lista. Cada marcador hace referencia a un índice de página específico, permitiendo una navegación precisa dentro del documento.

Documento de marcadores de una sola capa

¿Cómo crear jerarquías de marcadores multicapa?

IronPDF permite añadir marcadores en una estructura de árbol, lo que resulta especialmente útil para mantener la navegabilidad en documentos PDF de gran tamaño. Esta función es muy valiosa cuando se trata de colecciones extensas de documentos de examen, informes de ventas o registros de recibos de varias fechas y lugares en un único documento PDF. Al igual que crear formularios PDF para la recopilación de datos, los marcadores estructurados ayudan a organizar jerárquicamente la información compleja.

El método AddBookMarkAtEnd devuelve un objeto IPdfBookMark, permitiéndole agregar marcadores secundarios. Por ejemplo, use Children.AddBookMarkAtStart("Date1", 0) o Children.AddBookMarkAtEnd("Date1", 0) para agregar marcadores secundarios al marcador 'Examination'. Esta estructura anidada crea una organización jerárquica que refleja el flujo lógico del documento. El siguiente código demuestra este concepto:

:path=/static-assets/pdf/content-code-examples/how-to/bookmarks-multi-layer-bookmark.cs
using IronPdf;

// Load existing PDF document
PdfDocument pdf = PdfDocument.FromFile("examinationPaper.pdf");

// Assign IPdfBookMark object to a variable
var mainBookmark = pdf.Bookmarks.AddBookMarkAtEnd("Examination", 0);

// Add bookmark for days
var date1Bookmark = mainBookmark.Children.AddBookMarkAtStart("Date1", 1);

// Add bookmark for type of test
var paperBookmark = date1Bookmark.Children.AddBookMarkAtStart("Paper", 1);
paperBookmark.Children.AddBookMarkAtEnd("PersonA", 3);
paperBookmark.Children.AddBookMarkAtEnd("PersonB", 4);

// Add bookmark for days
var date2Bookmark = mainBookmark.Children.AddBookMarkAtEnd("Date2", 5);

// Add bookmark for type of test
var computerBookmark = date2Bookmark.Children.AddBookMarkAtStart("Computer", 5);
computerBookmark.Children.AddBookMarkAtEnd("PersonC", 6);
computerBookmark.Children.AddBookMarkAtEnd("PersonD", 7);

pdf.SaveAs("multiLayerBookmarks.pdf");
Imports IronPdf

' Load existing PDF document
Private pdf As PdfDocument = PdfDocument.FromFile("examinationPaper.pdf")

' Assign IPdfBookMark object to a variable
Private mainBookmark = pdf.Bookmarks.AddBookMarkAtEnd("Examination", 0)

' Add bookmark for days
Private date1Bookmark = mainBookmark.Children.AddBookMarkAtStart("Date1", 1)

' Add bookmark for type of test
Private paperBookmark = date1Bookmark.Children.AddBookMarkAtStart("Paper", 1)
paperBookmark.Children.AddBookMarkAtEnd("PersonA", 3)
paperBookmark.Children.AddBookMarkAtEnd("PersonB", 4)

' Add bookmark for days
Dim date2Bookmark = mainBookmark.Children.AddBookMarkAtEnd("Date2", 5)

' Add bookmark for type of test
Dim computerBookmark = date2Bookmark.Children.AddBookMarkAtStart("Computer", 5)
computerBookmark.Children.AddBookMarkAtEnd("PersonC", 6)
computerBookmark.Children.AddBookMarkAtEnd("PersonD", 7)

pdf.SaveAs("multiLayerBookmarks.pdf")
$vbLabelText   $csharpLabel

Este enfoque jerárquico es especialmente valioso cuando se trabaja con documentos complejos que requieren una organización detallada. La estructura anidada permite a los usuarios expandir y contraer secciones de marcadores, lo que hace que la navegación sea intuitiva incluso en documentos con cientos de páginas.

Documento de marcadores multicapa

¿Cómo puedo recuperar y navegar por los marcadores existentes?

IronPDF facilita la recuperación y visualización de marcadores en un documento PDF. Navegar a través del árbol de marcadores es sencillo y proporciona acceso sin interrupciones a diferentes secciones. Esta funcionalidad es esencial cuando se trabaja con PDF existentes que necesitan edición o cuando se implementan funciones como buscar y reemplazar texto dentro de secciones marcadas. Consider the multi-layer bookmarks document example above.

El marcador 'Examination' tiene una propiedad Children que apunta a los marcadores 'Date1' y 'Date2'. El marcador 'Date1' tiene una propiedad NextBookmark que apunta al marcador 'Date2'. Además, el marcador 'Date1' tiene una propiedad Children que contiene el marcador 'Paper'. Esta estructura interconectada permite sofisticados patrones de navegación y organización del documento.

Para recuperar todos los marcadores en el documento PDF abierto, utilice el método GetAllBookmarks. Se trata de una lista completa de todos los marcadores, que permite analizar y utilizar la estructura de marcadores:

:path=/static-assets/pdf/content-code-examples/how-to/bookmarks-retrieve-bookmark.cs
using IronPdf;

// Load existing PDF document
PdfDocument pdf = PdfDocument.FromFile("multiLayerBookmarks.pdf");

// Retrieve bookmarks list
var mainBookmark = pdf.Bookmarks.GetAllBookmarks();
Imports IronPdf

' Load existing PDF document
Private pdf As PdfDocument = PdfDocument.FromFile("multiLayerBookmarks.pdf")

' Retrieve bookmarks list
Private mainBookmark = pdf.Bookmarks.GetAllBookmarks()
$vbLabelText   $csharpLabel

Por favor notaLa combinación de dos documentos PDF con nombres de marcadores idénticos puede alterar la lista de marcadores.

AdvertenciaSolo se admiten marcadores creados a partir de índices de página. Los marcadores de otros elementos del PDF tendrán su valor de índice de página establecido en -1.

Aprende cómo crear un Índice cuando generes PDF desde HTML en el siguiente artículo: "Crear un Índice con IronPDF."

¿Listo para ver qué más puedes hacer? Consulte nuestra página de tutoriales aquí: Organizar PDFs

Marcadores PDF en expedientes fiscales y documentación empresarial española

La normativa fiscal española genera una demanda constante de documentos PDF extensos y bien estructurados. Los marcadores de IronPDF ofrecen valor real en los siguientes escenarios:

  • Expedientes de inspección tributaria para la AEAT: Cuando la Agencia Estatal de Administración Tributaria (AEAT) inicia una inspección, las empresas deben aportar expedientes documentales que pueden superar las cientos de páginas: facturas emitidas y recibidas, libros registro de IVA, declaraciones trimestrales, justificantes de operaciones. Un PDF con marcadores jerárquicos —organizado por ejercicio fiscal, tipo de documento y período— permite al inspector navegar directamente al apartado requerido sin hojear el documento completo.

  • Dossiers SII para revisión interna: Las empresas con volúmenes elevados de operaciones bajo el SII (Suministro Inmediato de Información) generan informes periódicos de conciliación entre los registros enviados a la AEAT y la contabilidad interna. Los marcadores multicapa —primer nivel por trimestre, segundo nivel por tipo de operación (emitidas, recibidas, intracomunitarias)— facilitan la revisión por el departamento financiero y la auditoría externa.

  • Portfolios de facturas Facturae para organismos públicos: Las empresas proveedoras del sector público acumulan portfolios de facturas enviadas a FACe (la plataforma estatal de facturas electrónicas). Un PDF compilado con marcadores por número de factura y estado (aceptada, en trámite, rechazada) permite al responsable de cobros identificar rápidamente las facturas pendientes de pago sin exportar datos a una hoja de cálculo.

  • Documentación de cumplimiento VeriFactu: Los ISVs de software de facturación deben mantener evidencias de que su sistema genera facturas conformes con VeriFactu. Los manuales técnicos y los informes de auditoría de conformidad se presentan ante la AEAT con marcadores que identifican cada sección del estándar técnico verificada, facilitando la revisión por los técnicos de la Agencia.

  • Libros de registro digitales bajo Crea y Crece: Con la implantación progresiva de la ley Crea y Crece (2027-2028), las empresas españolas deberán archivar sus facturas electrónicas en formato digital. Los portfolios anuales de facturas en PDF, con marcadores por mes y número de factura, son el formato de archivo más solicitado por los asesores fiscales españoles para la revisión contable periódica.

Preguntas Frecuentes

¿Cómo añado marcadores a un documento PDF en C#?

IronPDF facilita la adición de marcadores a documentos PDF en C#. Puede utilizar el método AddBookmarkAtEnd para añadir marcadores de una sola capa especificando el nombre del marcador y el índice de la página. Por ejemplo: pdf.Bookmarks.AddBookMarkAtEnd("Capítulo 1", 1). Esto crea ayudas de navegación similares a un índice que ayudan a los usuarios a saltar rápidamente a las secciones clave.

¿Cuál es la diferencia entre los métodos AddBookmarkAtEnd y AddBookmarkAtStart?

IronPDF proporciona dos métodos para la colocación de marcadores. El método AddBookMarkAtEnd añade marcadores al final de la lista de marcadores existente, mientras que AddBookMarkAtStart inserta marcadores al principio de la lista. Ambos métodos hacen referencia a índices de página específicos para una navegación precisa dentro del documento.

¿Puedo crear estructuras jerárquicas de marcadores con varios niveles?

Sí, IronPDF permite crear jerarquías de marcadores multicapa en una estructura de árbol. Esto resulta especialmente útil para organizar documentos complejos con secciones anidadas, de forma similar a como se estructuraría un índice detallado con capítulos y subcapítulos.

¿Es compatible la funcionalidad de los marcadores en distintos sistemas operativos?

La función de marcadores de IronPDF funciona perfectamente en entornos Windows, Linux y macOS. Puede añadir, editar y gestionar marcadores de PDF independientemente de su sistema operativo, lo que garantiza una funcionalidad coherente en diferentes plataformas.

¿Qué operaciones puedo realizar en los marcadores PDF existentes?

Con IronPDF, puede realizar varias operaciones en esquemas PDF existentes, como añadir nuevos marcadores, reordenarlos, editar las propiedades de los marcadores y eliminar marcadores no deseados. Esto le proporciona un control total sobre la organización y estructura de sus archivos PDF.

¿Cómo se muestran los marcadores cuando los usuarios abren el PDF?

En Adobe Acrobat Reader y otros visores de PDF similares, los marcadores creados con IronPDF aparecen como contornos en la barra lateral izquierda. Funcionan como una tabla de contenidos interactiva, que permite a los lectores navegar por documentos complejos de manera eficiente haciendo clic para saltar a secciones específicas.

¿Cómo estructurar marcadores PDF para expedientes de inspección tributaria de la AEAT?

Los expedientes documentales para inspecciones de la AEAT suelen superar las cientos de páginas. IronPDF permite crear marcadores jerárquicos multicapa: primer nivel por ejercicio fiscal, segundo nivel por tipo de documento (facturas emitidas, recibidas, declaraciones de IVA), tercer nivel por período. Esta estructura permite al inspector de la AEAT navegar directamente al apartado requerido sin hojear el documento completo.

Curtis Chau
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Nuget Descargas 19,014,616 | Versión: 2026.5 just released
Still Scrolling Icon

¿Aún desplazándote?

¿Quieres una prueba rápida? PM > Install-Package IronPdf
ejecutar una muestra Mira cómo tu HTML se convierte en PDF.