Accesibilidad PDF en C#: Crea, Convierte y Valida Documentos PDF/UA

El punto de inflexión legal

Tres desarrollos regulatorios han convergido para hacer urgente el cumplimiento de PDF/UA.

Éstos no son riesgos teóricos. Las demandas por accesibilidad han aumentado año tras año y los tribunales han sostenido sistemáticamente que los documentos digitales están dentro del ámbito de aplicación de la ley contra la discriminación por discapacidad. Las organizaciones que tratan la accesibilidad como una preocupación futura se encuentran cada vez más obligadas a defenderse de quejas, hallazgos de auditorías y litigios sobre documentos que su software produjo hace meses o años.

La Sección 508 de la Ley de Rehabilitación ha requerido que los Estados Unidos Las agencias federales y sus contratistas deben producir tecnología de información electrónica accesible durante años. Los archivos PDF están cubiertos explícitamente. Si su software genera documentos consumidos por o en nombre de una agencia federal, dichos documentos deben ser accesibles. El Departamento de Justicia investiga las quejas y toma medidas coercitivas contra las organizaciones que no cumplen las normas.

El Título II de la ADA extiende las obligaciones de accesibilidad a los gobiernos estatales y locales. La norma final del Departamento de Justicia, publicada en 2024, estableció plazos de cumplimiento para abril de 2026 para entidades con poblaciones de 50.000 o más habitantes y abril de 2027 para entidades más pequeñas. El alcance es amplio: cada PDF publicado en un sitio web gubernamental, distribuido por correo electrónico o generado a través de una aplicación para constituyentes debe cumplir con WCAG 2.1 Nivel AA. Se trata de agendas de reuniones, documentos presupuestarios, solicitudes de permisos, registros judiciales, mapas de zonificación y actas del consejo, entre muchos otros tipos de documentos.

La Ley Europea de Accesibilidad (EAA) entró en vigor en junio de 2025 y exige que los productos y servicios vendidos en la UE cumplan los requisitos de accesibilidad. Para las empresas de software que prestan servicios a clientes de la UE, los documentos que producen sus aplicaciones deben ser accesibles. Esto no se limita al gobierno; Se aplica a productos y servicios del sector privado en una amplia gama de categorías.

Qué requisitos reales tiene PDF/UA

PDF/UA (ISO 14289) define los requisitos técnicos que debe satisfacer un PDF para que las tecnologías de asistencia lo procesen de manera confiable. Un documento conforme debe tener:

Una estructura de etiquetas completa. Cada pieza de contenido significativo debe estar representada en un árbol de estructura lógica usando etiquetas PDF estándar: <h1> hasta <h6> para encabezados, <p> para párrafos, <Table> para tablas de datos, <Figure> para imágenes, y <l> para listas. El contenido que es puramente decorativo debe marcarse como un artefacto para que los lectores de pantalla lo omitan.

Un orden de lectura correcto. El árbol de etiquetas debe reflejar el orden lógico de lectura del contenido, no el orden visual en el que aparece en la página. Para diseños de varias columnas o documentos con barras laterales, esta distinción es muy importante.

Texto alternativo para contenido no textual. Cada imagen, gráfico y diagrama que comunique información debe tener texto alternativo adjunto a su etiqueta <Figure>. Las imágenes decorativas deben marcarse como artefactos.

Metadatos adecuados. El documento debe declarar su idioma (p. ej., "en" para inglés), tener un título representativo e incluir el identificador PDF/UA en sus metadatos XMP.

Fuentes incrustadas con asignaciones Unicode. Todas las fuentes deben estar incrustadas y las asignaciones de caracteres Unicode (ToUnicode CMap) deben estar presentes para que el texto pueda extraerse y leerse en voz alta con precisión.

PDF/UA vs WCAG: Cómo funcionan juntos los dos estándares

Los desarrolladores a menudo preguntan si deberían utilizar PDF/UA o WCAG. La respuesta es ambas, porque operan en capas diferentes.

WCAG (Pautas de Accesibilidad al Contenido Web) define los principios de accesibilidad y los criterios de éxito para el contenido web. Es el estándar al que hacen referencia la Sección 508, el Título II de la ADA y la EAA. WCAG le indica qué debe lograr el contenido accesible: perceptible, operable, comprensible y sólido.

PDF/UA te indica cómo lograr esos objetivos dentro de un archivo PDF. Es el estándar de implementación técnica. Un PDF que cumple con PDF/UA satisfará los criterios de éxito WCAG que se aplican al contenido del documento. Las dos normas son complementarias y no competidoras. En la práctica, si su flujo de trabajo produce archivos PDF etiquetados y bien estructurados que pasan la validación PDF/UA, también estará en excelente forma para cumplir con WCAG.

El requisito retroactivo

Un detalle que sorprende a las organizaciones: estas regulaciones no sólo se aplican a los documentos nuevos. También puede ser necesario remediar los archivos PDF existentes publicados en sitios web o distribuidos a través de aplicaciones. El Título II de la ADA requiere que el contenido web (incluidos los archivos PDF) publicado por los gobiernos estatales y locales cumpla con el Nivel AA de WCAG 2.1. No existe una exención general para los documentos heredados.

Esto hace que las herramientas de conversión programática sean esenciales. Remediar manualmente miles de archivos PDF no es práctico. Cubriremos los patrones de remediación por lotes más adelante en este tutorial.

PDF/UA-1(ISO 14289-1, basado en PDF 1.7)

PDF/UA-1 se publicó en 2012 y sigue siendo la versión más ampliamente adoptada del estándar. Se basa en la especificación PDF 1.7 y define un conjunto integral de requisitos para la estructura del PDF etiquetado, metadatos, fuentes y compatibilidad con tecnología de asistencia. La mayoría de las herramientas de validación, incluidas veraPDF y el verificador de accesibilidad de Adobe Acrobat, admitenPDF/UA-1como su objetivo principal.

Si está iniciando un nuevo proyecto de accesibilidad y necesita una amplia compatibilidad con herramientas y flujos de trabajo existentes,PDF/UA-1es la opción predeterminada segura. Cumple con los requisitos de la Sección 508, el Título II de la ADA y la Ley de Accesibilidad de la UE.

PDF/UA-2(ISO 14289-2:2024, basado en PDF 2.0)

PDF/UA-2 se publicó en 2024 y representa una actualización significativa. Desarrollado sobre la especificación PDF 2.0 (ISO 32000-2:2020), introduce un manejo mejorado de las funciones PDF modernas, incluidas anotaciones, campos de formulario, contenido multimedia y estructuras de documentos complejas.PDF/UA-2también proporciona una mejor alineación con los estándares de accesibilidad web en evolución.

IronPDF admite ambas versiones. Puede especificar cuál seleccionar al exportar, como demostraremos en los ejemplos de código a continuación.

WTPDF (PDF bien etiquetado) y cómo se relaciona

Es posible que encuentre referencias a WTPDF, que significa PDF bien etiquetado. Publicado por la PDF Association, WTPDF es un conjunto de directrices técnicas que aclaran cómo crear archivos PDF etiquetados correctamente. No es un estándar independiente, sino un complemento práctico dePDF/UA-2y PDF 2.0. WTPDF proporciona reglas detalladas para el uso de etiquetas, el mapeo de elementos de estructura y el etiquetado de contenido que van más allá de lo que define la propia especificación PDF/UA. Piense en ello como la guía de implementación que acompaña al estándar formal.

¿Qué versión deberías elegir?

Para la mayoría de los proyectos actuales, PDF/UA-1 es la opción ideal. Ofrece la mayor compatibilidad de herramientas, el ecosistema de validación más completo y cumple con todos los requisitos normativos vigentes. EligePDF/UA-2si necesitas específicamente funciones de PDF 2.0 como semántica de campos de formulario mejorada, mejor manejo de anotaciones o compatibilidad hacia adelante con nuevos estándares construidos sobre PDF 2.0.

IronPDF tiene como valor predeterminado PDF/UA-1 y permite cambiar fácilmente aPDF/UA-2cuando esté listo.

Cómo escribir HTML accesible

El HTML accesible se traduce naturalmente en una estructura PDF etiquetada y accesible. Estas son las prácticas que más importan:

Usar elementos HTML semánticos. Estructure su contenido con <h1> hasta <h6> para encabezados, <p> para párrafos, <ul> y <ol> para listas, <table> con <thead>, <tbody>, y <th> para tablas de datos, y <nav>, <main>, <article>, y <section> para la estructura de la página.

Proporcione texto alternativo para cada imagen significativa. Utilice el atributo alt en todas las etiquetas <img>. Para imágenes decorativas, utilice un alt="" vacío para indicar que la imagen debe tratarse como un artefacto.

Mantener una jerarquía de encabezados lógica. Comience con un único <h1>, y no omita niveles. Un documento que salta de <h1> a <h3> producirá un árbol de encabezados roto en la salida PDF.

Etiquetar campos de formularios. Si su HTML incluye elementos de formulario, asocie cada entrada con un elemento <label> usando el atributo for.

Configurar el idioma del documento. Incluya el atributo lang en su elemento <html> (por ejemplo, <html lang="en">).

Renderizado de HTML a PDF/UA con RenderHtmlAsPdfUA

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-accessibility-csharp-pdfua-tutorial/pdfua-render-html.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

string accessibleHtml = @"
<!DOCTYPE html>
<html lang='en'>
<head>
    <meta charset='UTF-8'>
    <title>Quarterly Accessibility Report</title>
    <style>
        body {
            font-family: Arial, sans-serif;
            line-height: 1.6;
            color: #333;
            max-width: 800px;
            margin: 0 auto;
            padding: 20px;
        }
        h1 {
            color: #1a1a1a;
            border-bottom: 2px solid #0066cc;
            padding-bottom: 8px;
        }
        h2 {
            color: #2a2a2a;
            margin-top: 24px;
        }
        table {
            border-collapse: collapse;
            width: 100%;
            margin: 16px 0;
        }
        th, td {
            border: 1px solid #ccc;
            padding: 10px;
            text-align: left;
        }
        th {
            background-color: #f0f0f0;
            font-weight: bold;
        }
        .summary {
            background-color: #f9f9f9;
            padding: 16px;
            border-left: 4px solid #0066cc;
            margin: 16px 0;
        }
    </style>
</head>
<body>
    <h1>Q3 2025 Accessibility Compliance Report</h1>

    <div class='summary'>
        <p>This report summarizes the accessibility remediation progress
        for all public-facing PDF documents across the organization.</p>
    </div>

    <h2>Document Inventory</h2>
    <p>The following table shows the current status of document
    remediation by department.</p>

    <table>
        <thead>
            <tr>
                <th scope='col'>Department</th>
                <th scope='col'>Total Documents</th>
                <th scope='col'>Compliant</th>
                <th scope='col'>Pending</th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td>Legal</td>
                <td>1,247</td>
                <td>892</td>
                <td>355</td>
            </tr>
            <tr>
                <td>Finance</td>
                <td>3,891</td>
                <td>3,102</td>
                <td>789</td>
            </tr>
            <tr>
                <td>Human Resources</td>
                <td>567</td>
                <td>401</td>
                <td>166</td>
            </tr>
        </tbody>
    </table>

    <h2>Key Findings</h2>
    <p>Three areas require immediate attention before the
    April 2026 deadline:</p>
    <ol>
        <li>Legacy court filing templates lack heading
        structure entirely.</li>
        <li>Financial statement PDFs generated before 2023
        have no tagged content.</li>
        <li>HR onboarding packets contain scanned images
        without OCR text layers.</li>
    </ol>

    <h2>Remediation Timeline</h2>
    <p>The project team recommends prioritizing public-facing
    documents first, followed by internal documents accessed by
    more than 50 employees.</p>

    <img src='timeline-chart.png'
         alt='Gantt chart showing remediation phases: Phase 1
         covers public documents from October through December
         2025, Phase 2 covers internal documents from January
         through March 2026.' />
</body>
</html>";

// Render directly to PDF/UA-compliant output
PdfDocument pdf = renderer.RenderHtmlAsPdfUA(accessibleHtml);

// Set document metadata (required by PDF/UA)
pdf.MetaData.Title  = "Q3 2025 Accessibility Compliance Report";
pdf.MetaData.Author = "Compliance Department";

pdf.SaveAs("accessibility-report-pdfua.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

Dim accessibleHtml As String = "
<!DOCTYPE html>
<html lang='en'>
<head>
    <meta charset='UTF-8'>
    <title>Quarterly Accessibility Report</title>
    <style>
        body {
            font-family: Arial, sans-serif;
            line-height: 1.6;
            color: #333;
            max-width: 800px;
            margin: 0 auto;
            padding: 20px;
        }
        h1 {
            color: #1a1a1a;
            border-bottom: 2px solid #0066cc;
            padding-bottom: 8px;
        }
        h2 {
            color: #2a2a2a;
            margin-top: 24px;
        }
        table {
            border-collapse: collapse;
            width: 100%;
            margin: 16px 0;
        }
        th, td {
            border: 1px solid #ccc;
            padding: 10px;
            text-align: left;
        }
        th {
            background-color: #f0f0f0;
            font-weight: bold;
        }
        .summary {
            background-color: #f9f9f9;
            padding: 16px;
            border-left: 4px solid #0066cc;
            margin: 16px 0;
        }
    </style>
</head>
<body>
    <h1>Q3 2025 Accessibility Compliance Report</h1>

    <div class='summary'>
        <p>This report summarizes the accessibility remediation progress
        for all public-facing PDF documents across the organization.</p>
    </div>

    <h2>Document Inventory</h2>
    <p>The following table shows the current status of document
    remediation by department.</p>

    <table>
        <thead>
            <tr>
                <th scope='col'>Department</th>
                <th scope='col'>Total Documents</th>
                <th scope='col'>Compliant</th>
                <th scope='col'>Pending</th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td>Legal</td>
                <td>1,247</td>
                <td>892</td>
                <td>355</td>
            </tr>
            <tr>
                <td>Finance</td>
                <td>3,891</td>
                <td>3,102</td>
                <td>789</td>
            </tr>
            <tr>
                <td>Human Resources</td>
                <td>567</td>
                <td>401</td>
                <td>166</td>
            </tr>
        </tbody>
    </table>

    <h2>Key Findings</h2>
    <p>Three areas require immediate attention before the
    April 2026 deadline:</p>
    <ol>
        <li>Legacy court filing templates lack heading
        structure entirely.</li>
        <li>Financial statement PDFs generated before 2023
        have no tagged content.</li>
        <li>HR onboarding packets contain scanned images
        without OCR text layers.</li>
    </ol>

    <h2>Remediation Timeline</h2>
    <p>The project team recommends prioritizing public-facing
    documents first, followed by internal documents accessed by
    more than 50 employees.</p>

    <img src='timeline-chart.png'
         alt='Gantt chart showing remediation phases: Phase 1
         covers public documents from October through December
         2025, Phase 2 covers internal documents from January
         through March 2026.' />
</body>
</html>"

' Render directly to PDF/UA-compliant output
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdfUA(accessibleHtml)

' Set document metadata (required by PDF/UA)
pdf.MetaData.Title = "Q3 2025 Accessibility Compliance Report"
pdf.MetaData.Author = "Compliance Department"

pdf.SaveAs("accessibility-report-pdfua.pdf")

Preservación de la estructura mediante la conversión

IronPDF utiliza un motor de renderizado Chromium integrado, la misma tecnología que impulsa Google Chrome y Microsoft Edge. Esto es importante para la accesibilidad porque Chromium ya entiende la semántica HTML. Cuando IronPDF convierte su HTML a PDF/UA, asigna elementos HTML a sus etiquetas PDF equivalentes:

<h1> hasta <h6> se convierten en etiquetas de encabezado <h1> a <h6>. <p> se convierte en etiquetas de párrafo <p>. <table>, <tr>, <th> y <td> se convierten en elementos de estructura <Table>, <tr>, <th> y <td>. <ul> y <ol> se convierten en <l> (Lista) con hijos <li> (Elemento de lista). <img> con texto alternativo se convierte en <Figure> con una entrada /Alt.

Esta asignación se realiza automáticamente. No es necesario construir manualmente un árbol de etiquetas PDF ni escribir ningún código de elemento de estructura.

Patrones HTML comunes que rompen la accesibilidad

Incluso los desarrolladores que escriben HTML generalmente limpio a veces utilizan patrones que producen resultados PDF inaccesibles. Esté atento a estos:

Usar <div> para todo. Un documento construido enteramente de elementos <div> sin estilo produce un árbol de etiquetas plano y sin estructura. Los lectores de pantalla no pueden navegar de manera significativa. Utilice elementos semánticos en su lugar.

Simular tablas con rejillas CSS o flexbox. Los datos presentados en un diseño de cuadrícula visual usando CSS pero no elementos reales de <table> no producirán etiquetas de tabla adecuadas en el PDF. Si el contenido es de datos tabulares, utilice un <table> real.

Saltearse niveles de encabezado. Saltar de <h1> a <h3> crea una brecha en la jerarquía de encabezados que los verificadores de accesibilidad marcarán como un fallo.

Imágenes sin texto alternativo. Cualquier etiqueta <img> que falte el atributo alt producirá una etiqueta <Figure> sin texto alternativo, lo cual es una violación directa de PDF/UA.

Texto incrustado en imágenes. Si su HTML incluye texto representado como imagen (capturas de pantalla de tablas, gráficos rasterizados), ese contenido es invisible para los lectores de pantalla. Utilice texto HTML real siempre que sea posible y proporcione texto alternativo completo para las imágenes restantes.

Salida predeterminada (PDF/UA-1)

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-accessibility-csharp-pdfua-tutorial/pdfua-default-output.cs

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("standard-report.pdf");

// Default: saves as PDF/UA-1
pdf.SaveAsPdfUA("accessible-report.pdf");

Imports IronPdf

Dim pdf As PdfDocument = PdfDocument.FromFile("standard-report.pdf")

' Default: saves as PDF/UA-1
pdf.SaveAsPdfUA("accessible-report.pdf")

Exportar comoPDF/UA-2con el parámetro Versión

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-accessibility-csharp-pdfua-tutorial/pdfua-export-pdfua2.cs

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("modern-form.pdf");

// Export as PDF/UA-2 (based on PDF 2.0)
pdf.SaveAsPdfUA("accessible-form-ua2.pdf", PdfUAVersions.PdfUA2);

Imports IronPdf

Dim pdf As PdfDocument = PdfDocument.FromFile("modern-form.pdf")

' Export as PDF/UA-2 (based on PDF 2.0)
pdf.SaveAsPdfUA("accessible-form-ua2.pdf", PdfUAVersions.PdfUA2)

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-accessibility-csharp-pdfua-tutorial/pdfua-in-memory-pdfua2.cs

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("complex-document.pdf");

// Convert to PDF/UA-2 in memory
pdf.ConvertToPdfUA(PdfUAVersions.PdfUA2);

// Perform additional modifications
pdf.MetaData.Title = "Complex Document - Accessible Version";

// Save the converted document
pdf.SaveAs("complex-document-accessible.pdf");

Imports IronPdf

Dim pdf As PdfDocument = PdfDocument.FromFile("complex-document.pdf")

' Convert to PDF/UA-2 in memory
pdf.ConvertToPdfUA(PdfUAVersions.PdfUA2)

' Perform additional modifications
pdf.MetaData.Title = "Complex Document - Accessible Version"

' Save the converted document
pdf.SaveAs("complex-document-accessible.pdf")

Cuándo utilizar PDF/UA-2

ConsiderePDF/UA-2cuando sus documentos dependen de características de PDF 2.0 quePDF/UA-1no puede abordar por completo. Esto incluye una accesibilidad mejorada a los campos de formulario con información semántica más rica, un manejo mejorado de anotaciones para comentarios, marcado y flujos de trabajo de revisión, un mejor soporte para contenido multimedia integrado en PDF y compatibilidad futura con estándares de accesibilidad emergentes basados ​​en PDF 2.0.

Para la mayoría de los proyectos de cumplimiento actuales,PDF/UA-1es la solución.PDF/UA-2es la opción con visión de futuro para los nuevos sistemas que no necesitarán procesar la salida en herramientas heredadas.

Validando con veraPDF

verapdf --profile ua1 output-quarterly-report-accessible.pdf

verapdf --profile ua1 output-quarterly-report-accessible.pdf

Entendiendo el Protocolo Matterhorn

El Protocolo Matterhorn es un conjunto de condiciones de prueba publicadas por la PDF Association que define exactamente cómo comprobar si un PDF cumple con el estándar PDF/UA-1. Organiza los controles en 31 puntos de control que cubren 136 condiciones de fallo específicas. Cada condición de falla se asigna a una cláusula en la especificación PDF/UA-1.

Por ejemplo, el punto de control 01 cubre si el catálogo de documentos contiene el identificador PDF/UA requerido. El punto de control 06 cubre si todas las fuentes están integradas con asignaciones Unicode válidas. El punto de control 13 cubre si los gráficos tienen texto alternativo apropiado.

Comprender el Protocolo Matterhorn le ayudará a interpretar los resultados de la validación y priorizar las correcciones. No todas las condiciones de falla tienen el mismo peso. La falta de un título en un documento se soluciona en cinco minutos. Un documento completamente sin etiquetas requiere una conversión completa.

Fallos comunes de cumplimiento y cómo solucionarlos

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-accessibility-csharp-pdfua-tutorial/pdfua-fix-document-title.cs

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("input.pdf");

// Set the required document title
pdf.MetaData.Title = "Annual Budget Report - FY2025";

pdf.SaveAsPdfUA("budget-report-accessible.pdf");

Imports IronPdf

Dim pdf As PdfDocument = PdfDocument.FromFile("input.pdf")

' Set the required document title
pdf.MetaData.Title = "Annual Budget Report - FY2025"

pdf.SaveAsPdfUA("budget-report-accessible.pdf")

Necesidades de fuentes, espacios de color y metadatos

PDF/UA tiene requisitos específicos en torno a la presentación visual que las herramientas automatizadas verifican. Todas las fuentes deben estar incrustadas con asignaciones ToUnicode correctas. El texto debe poder extraerse como caracteres Unicode. Los espacios de color deben ser independientes del dispositivo o tener un perfil ICC asociado. Los campos de formulario deben tener etiquetas y descripciones adecuadas.

IronPDF aborda la incrustación de fuentes, el espacio de color y los requisitos estructurales automáticamente durante la conversión. El idioma y los metadatos son fáciles de configurar en el código, como se muestra en los ejemplos a lo largo de este tutorial.

Comprobaciones manuales que la automatización no puede detectar

Algunos aspectos de la accesibilidad requieren revisión humana. Los validadores automáticos pueden decirle que una imagen tiene texto alternativo, pero no pueden juzgar si el texto alternativo es realmente útil. Pueden confirmar que existen encabezados, pero no pueden verificar que el texto del encabezado describa con precisión el contenido que sigue.

Incorpore un paso de revisión manual en su flujo de trabajo para documentos de alta prioridad. Concéntrese en si el texto alternativo describe con precisión el contenido de la imagen, si el orden de lectura tiene sentido lógico cuando se consume linealmente, si el texto del enlace es descriptivo (no solo "haga clic aquí") y si la declaración del idioma coincide con el contenido real del documento.

Herramientas de validación adicionales

veraPDF es el estándar para la verificación automatizada de conformidad con PDF/UA, pero otras herramientas pueden ser útiles además de él:

Adobe Acrobat Pro incluye un verificador de accesibilidad en Herramientas > Accesibilidad > Comprobación completa. Es útil para realizar comprobaciones visuales rápidas durante el desarrollo y genera un informe legible para humanos. La cobertura es menos completa que la de veraPDF para PDF/UA-1, pero está ampliamente disponible en la mayoría de los equipos.

PAC 2024 (PDF Accessibility Checker, gratuito para Windows) de la PDF Association ofrece una inspección visual del árbol de etiquetas junto con controles de conformidad con PDF/UA y WCAG. Es particularmente útil para inspeccionar el orden de lectura y la estructura del encabezado visualmente en lugar de a través de un informe de texto.

Acrobat Reader le permite abrir el panel Etiquetas directamente en Ver > Mostrar/Ocultar > Paneles de navegación > Etiquetas. Este no es un validador, pero proporciona una inspección visual rápida de la estructura del árbol sin necesidad de Acrobat Pro.

El enfoque más confiable es combinar veraPDF para verificaciones CI/CD automatizadas con una pasada manual en Acrobat o PAC para documentos de alta prioridad.

Conversión por lotes de bibliotecas de documentos a PDF/UA

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-accessibility-csharp-pdfua-tutorial/pdfua-batch-conversion.cs

using IronPdf;
using System;
using System.Collections.Concurrent;
using System.IO;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;

public class PdfUaBatchConverter
{
    private readonly SemaphoreSlim _semaphore;
    private readonly ConcurrentBag<string> _failures;
    private int _processed;

    public PdfUaBatchConverter(int maxConcurrency = 4)
    {
        _semaphore = new SemaphoreSlim(maxConcurrency);
        _failures  = new ConcurrentBag<string>();
        _processed = 0;
    }

    public async Task ConvertDirectoryAsync(
        string inputDirectory,
        string outputDirectory,
        NaturalLanguages language = NaturalLanguages.English)
    {
        Directory.CreateDirectory(outputDirectory);

        string[] pdfFiles  = Directory.GetFiles(inputDirectory, "*.pdf");
        int      totalFiles = pdfFiles.Length;

        Console.WriteLine($"Starting PDF/UA conversion: {totalFiles} files");
        Console.WriteLine($"Concurrency: {_semaphore.CurrentCount} parallel operations");
        Console.WriteLine($"Language: {language}");
        Console.WriteLine(new string('-', 50));

        var stopwatch = System.Diagnostics.Stopwatch.StartNew();

        var tasks = pdfFiles.Select(async inputPath =>
        {
            await _semaphore.WaitAsync();
            try
            {
                string fileName  = Path.GetFileName(inputPath);
                string outputPath = Path.Combine(outputDirectory, fileName);

                using (PdfDocument pdf = PdfDocument.FromFile(inputPath))
                {
                    pdf.SaveAsPdfUA(outputPath, NaturalLanguage: language);
                }

                int count = Interlocked.Increment(ref _processed);

                // Log progress every 10 files
                if (count % 10 == 0 || count == totalFiles)
                {
                    double rate = count / stopwatch.Elapsed.TotalSeconds;
                    Console.WriteLine(
                        $"  [{count}/{totalFiles}] " +
                        $"{rate:F1} files/sec");
                }
            }
            catch (Exception ex)
            {
                _failures.Add(
                    $"{Path.GetFileName(inputPath)}: {ex.Message}");
                Interlocked.Increment(ref _processed);
            }
            finally
            {
                _semaphore.Release();
            }
        });

        await Task.WhenAll(tasks);

        stopwatch.Stop();

        // Summary report
        Console.WriteLine(new string('-', 50));
        Console.WriteLine($"Completed in {stopwatch.Elapsed.TotalSeconds:F1}s");
        Console.WriteLine(
            $"Succeeded: {totalFiles - _failures.Count}  " +
            $"Failed: {_failures.Count}");

        if (_failures.Any())
        {
            Console.WriteLine("\nFailed files:");
            foreach (string failure in _failures)
                Console.WriteLine($"  - {failure}");

            // Write failures to log file for later review
            File.WriteAllLines(
                Path.Combine(outputDirectory, "_failures.log"),
                _failures);
        }
    }
}

// Usage
var converter = new PdfUaBatchConverter(
    maxConcurrency: Environment.ProcessorCount);

await converter.ConvertDirectoryAsync(
    inputDirectory:  @"C:\Documents\Legacy",
    outputDirectory: @"C:\Documents\Accessible",
    language: NaturalLanguages.English
);

Imports IronPdf
Imports System
Imports System.Collections.Concurrent
Imports System.IO
Imports System.Linq
Imports System.Threading
Imports System.Threading.Tasks

Public Class PdfUaBatchConverter
    Private ReadOnly _semaphore As SemaphoreSlim
    Private ReadOnly _failures As ConcurrentBag(Of String)
    Private _processed As Integer

    Public Sub New(Optional maxConcurrency As Integer = 4)
        _semaphore = New SemaphoreSlim(maxConcurrency)
        _failures = New ConcurrentBag(Of String)()
        _processed = 0
    End Sub

    Public Async Function ConvertDirectoryAsync(inputDirectory As String, outputDirectory As String, Optional language As NaturalLanguages = NaturalLanguages.English) As Task
        Directory.CreateDirectory(outputDirectory)

        Dim pdfFiles As String() = Directory.GetFiles(inputDirectory, "*.pdf")
        Dim totalFiles As Integer = pdfFiles.Length

        Console.WriteLine($"Starting PDF/UA conversion: {totalFiles} files")
        Console.WriteLine($"Concurrency: {_semaphore.CurrentCount} parallel operations")
        Console.WriteLine($"Language: {language}")
        Console.WriteLine(New String("-"c, 50))

        Dim stopwatch = System.Diagnostics.Stopwatch.StartNew()

        Dim tasks = pdfFiles.Select(Async Function(inputPath)
                                        Await _semaphore.WaitAsync()
                                        Try
                                            Dim fileName As String = Path.GetFileName(inputPath)
                                            Dim outputPath As String = Path.Combine(outputDirectory, fileName)

                                            Using pdf As PdfDocument = PdfDocument.FromFile(inputPath)
                                                pdf.SaveAsPdfUA(outputPath, NaturalLanguage:=language)
                                            End Using

                                            Dim count As Integer = Interlocked.Increment(_processed)

                                            ' Log progress every 10 files
                                            If count Mod 10 = 0 OrElse count = totalFiles Then
                                                Dim rate As Double = count / stopwatch.Elapsed.TotalSeconds
                                                Console.WriteLine($"  [{count}/{totalFiles}] {rate:F1} files/sec")
                                            End If
                                        Catch ex As Exception
                                            _failures.Add($"{Path.GetFileName(inputPath)}: {ex.Message}")
                                            Interlocked.Increment(_processed)
                                        Finally
                                            _semaphore.Release()
                                        End Try
                                    End Function)

        Await Task.WhenAll(tasks)

        stopwatch.Stop()

        ' Summary report
        Console.WriteLine(New String("-"c, 50))
        Console.WriteLine($"Completed in {stopwatch.Elapsed.TotalSeconds:F1}s")
        Console.WriteLine($"Succeeded: {totalFiles - _failures.Count}  Failed: {_failures.Count}")

        If _failures.Any() Then
            Console.WriteLine(vbCrLf & "Failed files:")
            For Each failure As String In _failures
                Console.WriteLine($"  - {failure}")
            Next

            ' Write failures to log file for later review
            File.WriteAllLines(Path.Combine(outputDirectory, "_failures.log"), _failures)
        End If
    End Function
End Class

' Usage
Dim converter As New PdfUaBatchConverter(maxConcurrency:=Environment.ProcessorCount)

Await converter.ConvertDirectoryAsync(inputDirectory:="C:\Documents\Legacy", outputDirectory:="C:\Documents\Accessible", language:=NaturalLanguages.English)

Lograr una conversión de accesibilidad automatizada del 80-90%

El 10-20% restante del trabajo de cumplimiento requiere criterio humano: texto alternativo significativo para imágenes complejas, correcciones del orden de lectura para diseños inusuales y asignaciones de encabezados semánticos para documentos que nunca se estructuraron correctamente en la fuente. Planifique un paso de revisión manual de sus documentos de mayor prioridad después de que se complete la revisión automática.

Priorizar la remediación

No todos los documentos conllevan el mismo riesgo de incumplimiento. Enfoque sus esfuerzos de remediación estratégicamente:

Los documentos públicos primero. Todo lo publicado en su sitio web, distribuido a clientes o enviado a una agencia gubernamental tiene máxima prioridad. Éstos son los documentos que con mayor probabilidad pueden generar quejas o auditorías.

En segundo lugar, se deben remediar con prontitud los documentos internos de acceso frecuente. Los materiales de capacitación, los manuales de políticas y los formularios de RR. HH. que muchos empleados utilizan habitualmente.

Los documentos de archivo y de bajo tráfico perduran. Los documentos antiguos con acceso mínimo pueden remediarse de forma continua o convertirse cuando alguien los solicita.

Este enfoque de triaje le permite demostrar el progreso del cumplimiento en los documentos más visibles mientras trabaja a lo largo de su archivo a lo largo del tiempo.

Combinación de PDF/UA con flujos de trabajo de fusión, firmas y metadatos

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-accessibility-csharp-pdfua-tutorial/pdfua-merge-metadata.cs

using IronPdf;

// Load and convert to PDF/UA in memory
PdfDocument report = PdfDocument.FromFile("financial-report.pdf");
report.ConvertToPdfUA();

// Set comprehensive metadata
report.MetaData.Title   = "Annual Financial Report 2025";
report.MetaData.Author  = "Finance Department";
report.MetaData.Subject = "Year-end financial summary and analysis";

// Merge with a cover page (also converted to PDF/UA)
PdfDocument coverPage = PdfDocument.FromFile("cover-page.pdf");
coverPage.ConvertToPdfUA();

PdfDocument finalDocument = PdfDocument.Merge(coverPage, report);

// Save the combined, accessible document
finalDocument.SaveAs("annual-report-final-accessible.pdf");

// Dispose of intermediate documents
report.Dispose();
coverPage.Dispose();

Imports IronPdf

' Load and convert to PDF/UA in memory
Dim report As PdfDocument = PdfDocument.FromFile("financial-report.pdf")
report.ConvertToPdfUA()

' Set comprehensive metadata
report.MetaData.Title = "Annual Financial Report 2025"
report.MetaData.Author = "Finance Department"
report.MetaData.Subject = "Year-end financial summary and analysis"

' Merge with a cover page (also converted to PDF/UA)
Dim coverPage As PdfDocument = PdfDocument.FromFile("cover-page.pdf")
coverPage.ConvertToPdfUA()

Dim finalDocument As PdfDocument = PdfDocument.Merge(coverPage, report)

' Save the combined, accessible document
finalDocument.SaveAs("annual-report-final-accessible.pdf")

' Dispose of intermediate documents
report.Dispose()
coverPage.Dispose()

Cuando necesita tanto archivo como accesibilidad

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-accessibility-csharp-pdfua-tutorial/pdfua-dual-compliance.cs

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("government-record.pdf");

// Convert to PDF/UA for accessibility
pdf.ConvertToPdfUA();

// Set required metadata
pdf.MetaData.Title  = "Public Hearing Minutes - January 2025";
pdf.MetaData.Author = "City Clerk's Office";

// Convert to PDF/A for archival compliance
pdf.SaveAsPdfA("government-record-archive.pdf");

Imports IronPdf

Dim pdf As PdfDocument = PdfDocument.FromFile("government-record.pdf")

' Convert to PDF/UA for accessibility
pdf.ConvertToPdfUA()

' Set required metadata
pdf.MetaData.Title = "Public Hearing Minutes - January 2025"
pdf.MetaData.Author = "City Clerk's Office"

' Convert to PDF/A for archival compliance
pdf.SaveAsPdfA("government-record-archive.pdf")

Combinación de PDF/UA con firmas digitales

Los documentos accesibles que también requieren autenticación pueden combinar la conversión de PDF/UA con firmas digitales . Aplique primero la conversión PDF/UA y luego firme el documento:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-accessibility-csharp-pdfua-tutorial/pdfua-digital-signature.cs

using IronPdf;
using IronPdf.Signing;

PdfDocument pdf = PdfDocument.FromFile("contract.pdf");
pdf.ConvertToPdfUA();

pdf.MetaData.Title = "Service Agreement - Executed Copy";

// Apply a digital signature to the accessible document
var signature = new PdfSignature("certificate.pfx", "password");
pdf.Sign(signature);

pdf.SaveAs("contract-accessible-signed.pdf");

Imports IronPdf
Imports IronPdf.Signing

Dim pdf As PdfDocument = PdfDocument.FromFile("contract.pdf")
pdf.ConvertToPdfUA()

pdf.MetaData.Title = "Service Agreement - Executed Copy"

' Apply a digital signature to the accessible document
Dim signature As New PdfSignature("certificate.pfx", "password")
pdf.Sign(signature)

pdf.SaveAs("contract-accessible-signed.pdf")

Documentos que garantizan el futuro de los estándares en evolución

Los estándares de accesibilidad continúan evolucionando. WCAG 2.2 se publicó en 2023 y el trabajo en WCAG 3.0 está en marcha.PDF/UA-2se alinea más de cerca con los estándares web modernos que PDF/UA-1. Al integrar la compatibilidad con PDF/UA en sus flujos de documentos ahora, crea una base que puede actualizarse a medida que evolucionan los estándares, en lugar de enfrentar una modificación completa más adelante.

La inversión en una infraestructura de documentos accesibles ofrece dividendos que van más allá del cumplimiento normativo. Los archivos PDF etiquetados correctamente se pueden buscar mejor, se adaptan mejor a los dispositivos móviles, producen mejores resultados de extracción de texto y funcionan de manera más confiable en diferentes visores y plataformas de PDF. La accesibilidad no es sólo un requisito legal. Es una mejor ingeniería.