在日常开发中，我们经常需要将轻量级的 Markdown 文档转换为格式固定、便于分享的 PDF 文件。本文将详细介绍如何使用 Spire.Doc for .NET 库，通过 C# 代码实现 Markdown 到 PDF 的高效转换，并涵盖核心步骤、进阶示例。
一、快速环境准备
Spire.Doc for .NET 支持.NET Framework/.NET Core/.NET 5+，跨平台兼容Windows/Linux/macOS，核心安装方式为NuGet：
# NuGet命令行安装Install-Package Spire.Doc二、基础转换：核心原理与代码拆解
1. 核心逻辑
Spire.Doc 的 Markdown 转 PDF 本质是“解析 Markdown → 构建 Document 文档模型 → 导出为 PDF”，核心依赖Document（文档容器）、FileFormat（格式标识）核心对象，流程如下：
Markdown文件 → LoadFromFile → Document模型 → SaveToFile(PDF)2. 完整基础代码（带逐行注释）
usingSpire.Doc;namespaceMdToDocx{classProgram{staticvoidMain(string[]args){// 初始化Document（核心容器，承载所有文档内容）Documentdoc=newDocument();// 加载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 文档的页面大小、方向、页边距：
usingSpire.Doc;namespaceMdToDocx{classProgram{staticvoidMain(string[]args){// 初始化Document对象Documentdoc=newDocument();// 加载 Markdown 文档doc.LoadFromFile("Sample.md",FileFormat.Markdown);// 页面配置（Section对应PDF的“页面对象”，可多Section分栏/分页）Sectionsection=document.Sections[0];// 页面大小：A4/Letter/A3section.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 文件。本文介绍了从基础转换到高级配置的完整流程，无论是处理单个文档还是批量转换任务都能轻松完成。
