Un informe escaneado puede contener información que deseas editar o agregar a tu documentación. Con OCR, puedes reconocer el texto en la imagen y guardarlo como Markdown en lugar de volver a escribirlo.

En este artículo, aprenderá cómo convertir una imagen PNG o JPG a Markdown en C# usando Aspose.OCR for .NET. También verá cómo la salida puede incluir tablas reconocidas e imágenes detectadas.

Biblioteca OCR C# para la conversión de imagen a Markdown

Aspose.OCR for .NET le permite reconocer texto en imágenes y guardar los resultados en varios formatos, incluido Markdown. Para este tutorial, use la versión 26.10.0 o posterior. La versión 26.10 introdujo la configuración DOCUMENT_LAYOUT utilizada en el ejemplo y mejoró la exportación a Markdown con información de diseño.

Instale el paquete en su proyecto de consola .NET usando el siguiente comando:

dotnet add package Aspose.OCR --version 26.10.0

También necesitarás una imagen PNG o JPG legible y permiso para escribir los archivos de salida. Para seguir el ejemplo, coloca una imagen llamada report.png en el directorio de tu proyecto.

La versión de prueba limita la cantidad de texto reconocido. Para eliminar esta restricción durante la evaluación, puedes solicitar una licencia temporal y aplicarla antes del reconocimiento. Consulta la documentación de licencias para obtener más detalles.

Convertir una imagen a Markdown en C#

Los siguientes pasos muestran cómo reconocer una imagen y guardar el resultado como Markdown:

  1. Crea una instancia de la clase AsposeOcr.
  2. Crea un objeto OcrInput para una sola imagen y agrega el archivo de imagen.
  3. Establece DetectAreasMode a DOCUMENT_LAYOUT en un objeto RecognitionSettings.
  4. Llama al método Recognize para procesar la imagen.
  5. Guarda los resultados usando OcrOutput.Save y SaveFormat.Md.

Para este ejemplo, use una imagen de un informe que contenga un encabezado, texto, una tabla y una ilustración. Reemplace el contenido de Program.cs con el siguiente código:

using Aspose.OCR;

// Create the OCR engine.
AsposeOcr recognitionEngine = new AsposeOcr();

// Add the image to the input.
OcrInput input = new OcrInput(InputType.SingleImage);
input.Add("report.png");

// Enable document layout detection.
RecognitionSettings settings = new RecognitionSettings
{
    DetectAreasMode = DetectAreasMode.DOCUMENT_LAYOUT
};

// Recognize the image.
OcrOutput results = recognitionEngine.Recognize(input, settings);

// Save the recognition result as Markdown.
results.Save("report.md", SaveFormat.Md);

Ejecute la aplicación desde el directorio del proyecto:

dotnet run

La aplicación lee report.png y guarda el resultado del reconocimiento como report.md. Ambas rutas son relativas al directorio de trabajo actual de la aplicación. Para una imagen JPG, cambie la ruta de entrada a su archivo JPG; los pasos de reconocimiento y exportación siguen siendo los mismos.

DOCUMENT_LAYOUT detecta los elementos del documento que pueden usarse para organizar la salida Markdown. El resultado depende de la imagen y del contenido reconocido, por lo que revise la salida con respecto al original. El ejemplo sigue las Aspose.OCR 26.10 release notes.

Revisar el Markdown generado

Abra report.md en un editor de texto o visor de Markdown. Puede editar el texto reconocido y ajustar su estructura según sea necesario. Cuando el motor OCR reconoce una tabla, la exportación puede representarla como una tabla Markdown.

El siguiente extracto ilustra la sintaxis de tablas e imágenes en Markdown. No es una salida real de OCR; el contenido y las rutas en su resultado dependerán de la imagen fuente y del reconocimiento:

## Quarterly Report

| Product | Sales |
| --- | --- |
| Product A | 120 |

![Detected illustration](path-to-extracted-image)

Cuando se detecta una imagen y se incluye en la salida del archivo, Aspose.OCR puede guardarla en un directorio de imágenes específico del documento junto al Markdown generado y agregar una referencia a ella. Mantenga el archivo Markdown y sus imágenes referenciadas juntos, conservando las rutas en el archivo, para que las imágenes se puedan mostrar en su visor de Markdown.

Markdown describe el contenido y la estructura; no necesariamente reproduce la apariencia exacta del informe original.

Consejos para obtener mejores resultados de OCR

  • Use una imagen fuente clara. El texto y los bordes de la tabla deben ser legibles en la imagen original.
  • Elija el idioma de reconocimiento apropiado. Establezca RecognitionSettings.Language cuando sea necesario. Algunos idiomas requieren un modelo de reconocimiento adicional; consulte la documentación de idiomas.
  • Verifique los detalles importantes. Compare nombres, números, celdas de tabla y el orden de lectura con la imagen fuente.
  • Verifique las referencias de imágenes. Abra el Markdown en un visor y compruebe que las imágenes extraídas aparecen.
  • Pruebe documentos representativos. Las tablas y diseños complejos pueden necesitar correcciones manuales, por lo que debe revisar los ejemplos antes de usar la salida en un flujo de trabajo automatizado.

Preguntas frecuentes

¿Puedo convertir tanto imágenes PNG como JPG a Markdown en C#?

Sí. Agregue el archivo PNG o JPG a OcrInput, reconózcalo y guarde los resultados con SaveFormat.Md.

¿Puede la salida de Markdown contener tablas?

Sí. Las tablas reconocidas pueden exportarse como tablas Markdown. El resultado depende de la imagen de origen y de cómo se reconoce la tabla.

¿Dónde se guardan las imágenes detectadas?

Para la salida de archivos, las imágenes detectadas pueden guardarse en un directorio de imágenes específico del documento junto al Markdown generado. El contenido Markdown hace referencia a esos archivos.

¿El archivo Markdown conserva exactamente el diseño original de la página?

No. Markdown representa el contenido y la estructura de manera diferente a una imagen de página. Revise el archivo generado y ajuste la estructura donde sea necesario.

Conclusión

Utilice este flujo de trabajo como punto de partida para convertir sus propios informes o páginas escaneadas a Markdown. Antes de agregar los resultados a su documentación, compare el texto, las tablas y las referencias de imágenes con el original.

Para obtener más información, consulte la documentación de reconocimiento. Si necesita ayuda, visite el foro de soporte de Aspose.OCR.

Véase también