如何通过 C# 将 Markdown 转换为 PDF 文档

在日常开发中，我们经常需要将轻量级的 Markdown 文档转换为格式固定、便于分享的 PDF 文件。本文将详细介绍如何使用 Spire.Doc for .NET 库，通过 C# 代码实现 Markdown 到 PDF 的高效转换，并涵盖核心步骤、进阶示例。

一、快速环境准备

Spire.Doc for .NET 支持.NET Framework/.NET Core/.NET 5+，跨平台兼容Windows/Linux/macOS，核心安装方式为NuGet：

bash 复制代码

# NuGet命令行安装
Install-Package Spire.Doc

二、基础转换：核心原理与代码拆解

1. 核心逻辑

Spire.Doc 的 Markdown 转 PDF 本质是"解析 Markdown → 构建 Document 文档模型 → 导出为 PDF"，核心依赖Document（文档容器）、FileFormat（格式标识）核心对象，流程如下：

复制代码

Markdown文件 → LoadFromFile → Document模型 → SaveToFile(PDF)

2. 完整基础代码（带逐行注释）

csharp 复制代码

using Spire.Doc;

namespace MdToDocx
{
    class Program
    {
        static void Main(string[] args)
        {
            // 初始化Document（核心容器，承载所有文档内容）
            Document doc = new Document();

            // 加载Markdown：指定FileFormat.Markdown触发语法解析
            doc.LoadFromFile("Sample.md", FileFormat.Markdown);

            // 导出PDF：指定FileFormat.PDF，底层自动完成模型转PDF渲染
            doc.SaveToFile("MarkdownToPDF.pdf", FileFormat.PDF);
            doc.Close();
        }
    }
}

3. 核心API细节

Document：创建文档容器，所有 Markdown 解析、PDF 导出都基于此对象
LoadFromFile：第二个参数指定 FileFormat.Markdown ，支持解析 Markdown 核心语法（标题、列表、表格等）
SaveToFile：导出为 PDF 文档，自动处理换行、缩进等样式

三、进阶场景：自定义 PDF 页面设置

Markdown 转 PDF 时，可通过 PageSetup 设置输出 PDF 文档的页面大小、方向、页边距：

csharp 复制代码

using Spire.Doc;

namespace MdToDocx
{
    class Program
    {
        static void Main(string[] args)
        {
            // 初始化Document对象
            Document doc = new Document();

            // 加载 Markdown 文档
            doc.LoadFromFile("Sample.md", FileFormat.Markdown);

            // 页面配置（Section对应PDF的"页面对象"，可多Section分栏/分页）
            Section section = document.Sections[0];
            // 页面大小：A4/Letter/A3
             section.PageSetup.PageSize = PageSize.A4;
            // 页面方向：Portrait（纵向）/Landscape（横向）
            section.PageSetup.Orientation = PageOrientation.Portrait;
            // 页边距:上、下、左、右
            section.PageSetup.Margins.Top = 17.9f;
            section.PageSetup.Margins.Bottom = 17.9f;
            section.PageSetup.Margins.Left = 17.9f;
            section.PageSetup.Margins.Right = 17.9f;
 
            // 导出 PDF 格式
            doc.SaveToFile("MarkdownToPDF.pdf", FileFormat.PDF);
            doc.Close();
        }
    }
}

通过以上示例，我们可以轻松地将 Markdown 文档转换为高质量的 PDF 文件。本文介绍了从基础转换到高级配置的完整流程，无论是处理单个文档还是批量转换任务都能轻松完成。