扫描报告可能包含您想要编辑或添加到文档中的信息。使用 OCR，您可以识别图像中的文本，并将其保存为 Markdown，而无需重新键入。

在本文中，您将学习如何在 C# 中使用 Aspose.OCR for .NET 将 PNG 或 JPG 图像转换为 Markdown。您还将看到输出如何包含已识别的表格和检测到的图像。

C# OCR 库用于图像到 Markdown 的转换

Aspose.OCR for .NET 让您识别图像中的文本并将结果保存为多种格式，包括 Markdown。对于本教程，请使用 26.10.0 或更高 版本。26.10 版引入了示例中使用的 DOCUMENT_LAYOUT 设置，并增强了带有布局信息的 Markdown 导出。

使用以下命令在您的 .NET 控制台项目中安装该包：

dotnet add package Aspose.OCR --version 26.10.0

您还需要一张可读取的 PNG 或 JPG 图像，并且需要有写入输出文件的权限。要遵循示例，请在项目目录中放置名为 report.png 的图像。

试用版限制了可识别的文本量。要在评估期间解除此限制，您可以请求临时许可证并在识别之前应用它。有关详细信息，请参阅许可文档。

在 C# 中将图像转换为 Markdown

以下步骤演示如何识别图像并将结果保存为 Markdown：

  1. 创建 AsposeOcr 类的实例。
  2. 为单个图像创建 OcrInput 对象并添加图像文件。
  3. 在 RecognitionSettings 对象中将 DetectAreasMode 设置为 DOCUMENT_LAYOUT。
  4. 调用 Recognize 方法处理图像。
  5. 使用 OcrOutput.Save 和 SaveFormat.Md 保存结果。

对于此示例，使用包含标题、文本、表格和插图的报告图像。将 Program.cs 的内容替换为以下代码：

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

从项目目录运行应用程序：

dotnet run

应用程序读取 report.png 并将识别结果保存为 report.md。这两个路径相对于应用程序的当前工作目录。对于 JPG 图像，请将输入路径更改为您的 JPG 文件；识别和导出步骤保持不变。

DOCUMENT_LAYOUT 检测文档元素，可用于组织 Markdown 输出。结果取决于图像和识别的内容，因此请将输出与原始内容进行对比检查。示例遵循 Aspose.OCR 26.10 发布说明。

审阅生成的 Markdown

在文本编辑器或 Markdown 查看器中打开 report.md。您可以编辑识别的文本并根据需要调整其结构。当 OCR 引擎识别表格时，导出可以将其表示为 Markdown 表格。

以下摘录演示了 Markdown 表格和图像语法。它 不是实际的 OCR 输出；结果中的内容和路径将取决于源图像和识别情况：

## Quarterly Report

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

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

当检测到图像并将其包含在文件输出中时，Aspose.OCR 可以将其保存到生成的 Markdown 文件旁边的特定文档图像目录中，并添加对该图像的引用。请将 Markdown 文件及其引用的图像一起保留，保持文件中的路径不变，以便在 Markdown 查看器中显示图像。

Markdown 描述内容和结构；它不一定会完全再现原始报告的外观。

提高 OCR 结果的技巧

  • 使用清晰的源图像。 文本和表格边框应在原始图像中可读。
  • 选择合适的识别语言。 在需要时设置 RecognitionSettings.Language。某些语言需要额外的识别模型；请参阅语言文档。
  • 检查重要细节。 将名称、数字、表格单元格和阅读顺序与源图像进行比较。
  • 验证图像引用。 在查看器中打开 Markdown 并检查提取的图像是否出现。
  • 测试代表性文档。 复杂的表格和布局可能需要手动校正，因此在将输出用于自动化工作流之前，请先审阅示例。

常见问题

我可以在 C# 中将 PNG 和 JPG 图像都转换为 Markdown 吗？

是的。将 PNG 或 JPG 文件添加到 OcrInput，进行识别，并使用 SaveFormat.Md 保存结果。

Markdown 输出可以包含表格吗？

是的。已识别的表格可以导出为 Markdown 表格。结果取决于源图像以及表格的识别方式。

检测到的图像保存在哪里？

对于文件输出，检测到的图像可以保存到生成的 Markdown 旁边的特定文档图像目录中。Markdown 内容会引用这些文件。

Markdown 文件是否精确保留原始页面布局？

不。Markdown 以不同于页面图像的方式表示内容和结构。请检查生成的文件，并在需要时调整结构。

结论

使用此工作流作为将您自己的报告或扫描页面转换为 Markdown 的起点。在将结果添加到文档之前，请将文本、表格和图像引用与原始内容进行比较。

欲了解更多信息，请参阅识别文档。如果需要帮助，请访问Aspose.OCR 支持论坛。

另请参阅