用 C# 将 Markdown 转换为 DOCX

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

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

在线 Markdown 转换器

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

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

用 C# 将 Markdown 转换为 DOCX

从 Markdown 到其他格式的转换需要经过 Markdown 到 HTML 的转换阶段。例如，如果您需要将 Markdown 文档转换为 DOCX 文件格式，下面的示例演示了如何将其转换为 DOCX 文件格式：

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

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

// Convert Markdown to DOCX 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" +
              "Convert Markdown to DOCX!";

// Create a Markdown file
File.WriteAllText(sourcePath, code);

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

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

// Convert HTML document to DOCX file format
Converter.ConvertHTML(document, new DocSaveOptions(), savePath);

使用 DocSaveOptions 将 Markdown 转换为 DOCX

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

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

以下代码片段展示了如何使用自定义保存选项将 Markdown 转换为 DOCX：

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

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

// Prepare a path for converted DOCX file saving 
string savePath = Path.Combine(OutputDir, "nature-output.docx");

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

// Initialize DocSaveOptions. Set up the page-size 500x1000 pixels and margins 
DocSaveOptions options = new DocSaveOptions();
options.PageSetup.AnyPage = new Page(new Aspose.Html.Drawing.Size(500, 1000), new Margin(20, 20, 10, 10));

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

DocSaveOptions 类提供的属性可以让你完全控制各种参数，并改进将 Markdown 转换为 DOCX 格式的过程。在示例中，我们使用 PageSetup 属性来指定 DOCX 文档的页面大小。要了解有关 DocSaveOptions 的更多信息，请阅读 微调转换器 一文。

Aspose.HTML 提供免费的在线 MD 到 DOCX 转换器，可将 Markdown 文件高质量、简单、快速地转换为 DOCX 文件。只需上传、转换文件，几秒钟就能得到结果！