将 Markdown 转换为 PDF – C#

Markdown 是一种使用纯文本格式语法的标记语言。Markdown 经常被用作文档和自述文件的格式，因为它能以一种易读易写的风格进行书写。它的设计使其可以轻松转换为多种输出格式，但最初创建时只能转换为 HTML 格式。 在您的 C# 应用程序中使用 Aspose.HTML for .NET 库，只需几行代码，您就可以轻松地将 Markdown 转换为 PDF 文件！

本文介绍了如何使用 Aspose.HTML for .NET API 将 Markdown 转换为 PDF。您将了解所支持的 Markdown 到 PDF 的转换场景，并考虑用 C# 示例来说明这些场景。此外，您还可以尝试使用在线 Markdown 转换器来测试 Aspose.HTML API 的功能并即时转换 Markdown。

在线 Markdown 转换器

您可以使用 Aspose.HTML for .NET API 实时将 Markdown 转换为其他格式。请从本地文件系统加载一个 Markdown 文件，选择输出格式并运行示例。 保存选项是默认设置的。您将立即以单独文件的形式收到转换结果。

如果您想以编程方式将 Markdown 转换为 PDF，请参阅以下 C# 代码示例。

注： 从 Markdown 转换为 PDF、XPS、DOCX 等格式以及图像格式时，需要经过 Markdown 到 HTML 的转换阶段。

用 C# 将 Markdown 转换为 PDF

例如，如果您需要将 Markdown 文档渲染为 PDF 文件格式，下面的示例演示了如何简单地实现这一点：

1. 准备一个源 Markdown 文档。在示例中，我们根据代码创建一个 Markdown 文件。
2. 为转换后的文件保存准备路径。
3. 将 Markdown 转换为 HTML。使用 ConvertMarkdown(sourcePath) 方法将 Markdown 保存为 HTML 文档。
4. 使用 ConvertHTML() 方法将中介 HTML 文档渲染为 PDF 格式。您需要向 ConvertHTML() 方法传递 HTMLDocument、PdfSaveOptions 和输出文件路径，以实现 HTML 到 PDF 的转换。

如果您想直接在代码中根据用户字符串创建 Markdown 文档并将其转换为 PDF 文件，下面的示例可以帮到您：

// Convert Markdown to PDF using C#

// Prepare a path to a source Markdown file
string sourcePath = Path.Combine(OutputDir, "document.md");

// Prepare a simple Markdown example
string code = "### Hello, World!" +
              "\r\n" +
              "[visit applications](https://products.aspose.app/html/applications)";
// Create a Markdown file
File.WriteAllText(sourcePath, code);

// Convert Markdown to HTML 
using HTMLDocument document = Converter.ConvertMarkdown(sourcePath);

// Prepare a path for converted PDF file saving 
string savePath = Path.Combine(OutputDir, "document-output.pdf");

// Convert the HTML document to PDF file format
Converter.ConvertHTML(document, new PdfSaveOptions(), savePath);

使用 PdfSaveOptions 将 Markdown 转换为 PDF

如果您要从本地文件系统转换现有的 Markdown 文档，下面的示例可以帮到您。您需要遵循以下几个步骤：

1. 打开现有的 Markdown 文档。在示例中，我们从本地文件系统加载了一个 Markdown 文件( nature.md)。
2. 为转换后的 PDF 文件保存准备路径。
3. 将 Markdown 转换为 HTML。使用转换器类的 ConvertMarkdown(sourcePath) 方法将 Markdown 保存为 HTML 文档。
4. 创建一个新的 PdfSaveOptions 对象，并指定所需的属性。
5. 使用 ConvertHTML() 方法将中介 HTML 文档渲染为 PDF 格式。您需要向 ConvertHTML() 方法传递 HTMLDocument、PdfSaveOptions 和输出文件路径。

以下代码片段展示了如何使用 Aspose.HTML for .NET 将 Markdown 转换为 PDF。

// Convert Markdown to PDF in C# with custom settings

// Prepare a path to a source Markdown file
string sourcePath = Path.Combine(DataDir, "nature.md");

// Prepare a path to save the converted file
string savePath = Path.Combine(OutputDir, "nature-output.pdf");

// Convert Markdown to HTML
using HTMLDocument document = Converter.ConvertMarkdown(sourcePath);

// Initialize PdfSaveOptions. Set up the resolutions, JpegQuality and change the background color to AliceBlue 
PdfSaveOptions options = new PdfSaveOptions()
{
    HorizontalResolution = 200,
    VerticalResolution = 200,
    BackgroundColor = System.Drawing.Color.AliceBlue,
    JpegQuality = 100
};

// Convert the HTML document to PDF file format
Converter.ConvertHTML(document, options, savePath);

PdfSaveOptions 类提供了大量属性，让你可以完全控制各种参数，并改进将 Markdown 转换为 PDF 格式的过程。要了解有关 PdfSaveOptions 的更多信息，请阅读 微调转换器 一文。

在上述示例中，我们使用

• JpegQuality 属性，用于指定图像的 JPEG 压缩质量。默认值为 95。
• BackgroundColor 属性，用于设置填充背景的颜色。默认的 BackgroundColor 是透明色。
• HorizontalResolution 和 VerticalResolution 属性以每英寸像素为单位设置输出图像的水平/垂直分辨率。默认情况下，这些属性为 300 dpi。

下载 Aspose.HTML for .NET库，它能让您成功、快速、轻松地将 HTML、MHTML、EPUB、SVG 和 Markdown 文档转换为最流行的格式。

您可以使用我们的在线 MD 到 PDF 转换器 检查 Markdown 转换为 PDF 的质量。上传、转换您的文件并在几秒钟内获得结果。现在就免费试用我们的 Markdown to PDF Converter！