Ein gescannter Bericht kann Informationen enthalten, die Sie bearbeiten oder zu Ihrer Dokumentation hinzufügen möchten. Mit OCR können Sie Text im Bild erkennen und ihn als Markdown speichern, anstatt ihn erneut zu tippen.

In diesem Artikel erfahren Sie, wie Sie ein PNG‑ oder JPG‑Bild in Markdown in C# mit Aspose.OCR for .NET konvertieren. Außerdem sehen Sie, wie die Ausgabe erkannte Tabellen und erkannte Bilder enthalten kann.

C# OCR-Bibliothek für Bild-zu-Markdown-Konvertierung

Aspose.OCR for .NET ermöglicht es Ihnen, Text in Bildern zu erkennen und die Ergebnisse in mehreren Formaten zu speichern, einschließlich Markdown. Für dieses Tutorial verwenden Sie Version 26.10.0 oder höher. Version 26.10 führte die Einstellung DOCUMENT_LAYOUT ein, die im Beispiel verwendet wird, und verbesserte den Markdown‑Export mit Layout‑Informationen.

Installieren Sie das Paket in Ihrem .NET‑Konsolenprojekt mit dem folgenden Befehl:

dotnet add package Aspose.OCR --version 26.10.0

Sie benötigen außerdem ein lesbares PNG‑ oder JPG‑Bild und die Berechtigung, die Ausgabedateien zu schreiben. Um dem Beispiel zu folgen, legen Sie ein Bild mit dem Namen report.png in Ihrem Projektverzeichnis ab.

Die Testversion begrenzt die Menge des erkannten Textes. Um diese Einschränkung während der Evaluierung zu entfernen, können Sie eine temporäre Lizenz anfordern und sie vor der Erkennung anwenden. Siehe die Lizenzierungsdokumentation für Details.

Bild in Markdown konvertieren in C#

Die folgenden Schritte zeigen, wie man ein Bild erkennt und das Ergebnis als Markdown speichert:

  1. Erstellen Sie eine Instanz der AsposeOcr-Klasse.
  2. Erstellen Sie ein OcrInput-Objekt für ein einzelnes Bild und fügen Sie die Bilddatei hinzu.
  3. Setzen Sie DetectAreasMode auf DOCUMENT_LAYOUT in einem RecognitionSettings-Objekt.
  4. Rufen Sie die Recognize-Methode auf, um das Bild zu verarbeiten.
  5. Speichern Sie die Ergebnisse mit OcrOutput.Save und SaveFormat.Md.

Verwenden Sie für dieses Beispiel ein Bild eines Berichts, das eine Überschrift, Text, eine Tabelle und eine Abbildung enthält. Ersetzen Sie den Inhalt von Program.cs durch den folgenden Code:

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);

Führen Sie die Anwendung aus dem Projektverzeichnis aus:

dotnet run

Die Anwendung liest report.png und speichert das Erkennungsergebnis als report.md. Beide Pfade sind relativ zum aktuellen Arbeitsverzeichnis der Anwendung. Für ein JPG‑Bild ändern Sie den Eingabepfad zu Ihrer JPG‑Datei; die Erkennungs‑ und Export‑Schritte bleiben gleich.

DOCUMENT_LAYOUT erkennt Dokumentelemente, die zur Organisation der Markdown‑Ausgabe verwendet werden können. Das Ergebnis hängt vom Bild und dem erkannten Inhalt ab, daher sollten Sie die Ausgabe mit dem Original vergleichen. Das Beispiel folgt den Aspose.OCR 26.10 Release-Notizen.

Überprüfen Sie das generierte Markdown

Öffnen Sie report.md in einem Texteditor oder Markdown‑Betrachter. Sie können den erkannten Text bearbeiten und die Struktur bei Bedarf anpassen. Wenn die OCR‑Engine eine Tabelle erkennt, kann der Export sie als Markdown‑Tabelle darstellen.

Der folgende Auszug veranschaulicht die Markdown‑Tabellen‑ und Bildsyntax. Es ist keine tatsächliche OCR‑Ausgabe; der Inhalt und die Pfade in Ihrem Ergebnis hängen vom Quellbild und der Erkennung ab:

## Quarterly Report

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

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

Wenn ein Bild erkannt und in die Dateiausgabe aufgenommen wird, kann Aspose.OCR es in einem dokument‑spezifischen Bildverzeichnis neben dem erzeugten Markdown speichern und einen Verweis darauf hinzufügen. Halten Sie die Markdown‑Datei und ihre referenzierten Bilder zusammen, wobei Sie die Pfade in der Datei beibehalten, damit die Bilder in Ihrem Markdown‑Viewer angezeigt werden können.

Markdown beschreibt Inhalt und Struktur; es reproduziert nicht unbedingt das genaue Aussehen des Originalberichts.

Tipps für bessere OCR-Ergebnisse

  • Verwenden Sie ein klares Quellbild. Text- und Tabellenränder sollten im Originalbild lesbar sein.
  • Wählen Sie die passende Erkennungssprache. Setzen Sie RecognitionSettings.Language bei Bedarf. Für einige Sprachen ist ein zusätzliches Erkennungsmodell erforderlich; siehe die language documentation.
  • Überprüfen Sie wichtige Details. Vergleichen Sie Namen, Zahlen, Tabellenzellen und die Lesereihenfolge mit dem Quellbild.
  • Verifizieren Sie Bildreferenzen. Öffnen Sie das Markdown in einem Viewer und prüfen Sie, ob extrahierte Bilder angezeigt werden.
  • Testen Sie repräsentative Dokumente. Komplexe Tabellen und Layouts können manuelle Korrekturen erfordern, daher sollten Sie Beispiele prüfen, bevor Sie die Ausgabe in einem automatisierten Workflow verwenden.

Häufig gestellte Fragen

Kann ich sowohl PNG- als auch JPG-Bilder in Markdown mit C# konvertieren?

Ja. Fügen Sie die PNG‑ oder JPG‑Datei zu OcrInput hinzu, erkennen Sie sie und speichern Sie die Ergebnisse mit SaveFormat.Md.

Kann die Markdown-Ausgabe Tabellen enthalten?

Ja. Erkannte Tabellen können als Markdown-Tabellen exportiert werden. Das Ergebnis hängt vom Quellbild und davon ab, wie die Tabelle erkannt wird.

Wo werden erkannte Bilder gespeichert?

Für die Dateiausgabe können erkannte Bilder in einem dokumentenspezifischen Bildverzeichnis neben dem erzeugten Markdown gespeichert werden. Der Markdown‑Inhalt verweist auf diese Dateien.

Behält die Markdown-Datei das ursprüngliche Seitenlayout exakt bei?

Hinweis: Markdown stellt Inhalte und Struktur anders dar als ein Seitenbild. Überprüfen Sie die erzeugte Datei und passen Sie die Struktur bei Bedarf an.

Fazit

Verwenden Sie diesen Workflow als Ausgangspunkt, um Ihre eigenen Berichte oder gescannten Seiten in Markdown zu konvertieren. Vergleichen Sie vor dem Hinzufügen der Ergebnisse zu Ihrer Dokumentation den Text, die Tabellen und die Bildverweise mit dem Original.

Für weitere Informationen siehe die Erkennungsdokumentation. Wenn Sie Hilfe benötigen, besuchen Sie das Aspose.OCR Support-Forum.

Siehe auch