如何通过 C# 实现 Markdown 转 HTML 格式

在日常开发中，Markdown 因简洁的语法、易读写的特性被广泛用于文档编写、博客发布、内容管理等场景。但很多场景下需要将 Markdown 转换为 HTML 展示（如网页端渲染），手动转换效率低且易出错。本文将分享如何基于 Spire.Doc for .NET 库，快速实现 Markdown 到 HTML 的高效转换，涵盖基础用法、进阶批量转换等示例。

一、环境准备

1. 安装 Spire.Doc

推荐通过 NuGet 包管理器安装，这是最便捷的方式：

Visual Studio中：右键项目 → 管理NuGet程序包 → 搜索Spire.Doc → 安装；
包管理器控制台命令：

powershell 复制代码

Install-Package Spire.Doc

2. 环境兼容说明

操作系统：Windows、Linux、macOS（.NET Core/.NET 5+环境）；
.NET版本：覆盖主流.NET框架，无需额外适配。

二、基础实现：Markdown 转 HTML

场景1：从字符串转换 Markdown 内容

适用于动态生成的 Markdown 内容（如用户输入、接口返回的 Markdown 文本），核心步骤为「创建文档对象 → 加载Markdown字符串 → 保存为HTML」。

完整代码示例：

csharp 复制代码

using Spire.Doc;
using System;
using System.IO;

namespace MarkdownToHtmlDemo
{
    class Program
    {
        static void Main(string[] args)
        {
          // 定义待转换的Markdown内容（标题、普通文本、粗体、斜体、超链接、无序列表）
          string markdownContent = @"
# C# Markdown转HTML实战
## 基于Spire.Doc for .NET
这是一段普通文本，包含**粗体文本**、*斜体文本*和[Spire.Doc官方链接](https://www.e-iceblue.com/)。

### 核心优势
- Markdown语法解析简洁高效
- 跨.NET框架兼容（.NET Framework/.NET Core/.NET 5+）
- 支持自定义HTML输出规则
- 无需依赖Microsoft Word等第三方软件

### 适用场景
- 博客系统内容渲染
- 文档管理平台格式转换
- 内容发布系统前端展示
";

          // 定义文件路径
          string markdownFilePath = "example.md"; // Path to save the Markdown file
          string outputHtmlPath = "output.html";   // Path to save the converted HTML file

          // 基于markdown字符串生成文件
          File.WriteAllText(markdownFilePath, markdown);

          // 加载文件
          Document document = new Document();
          document.LoadFromFile(markdownFilePath, FileFormat.Markdown);

          // 保存为HTML格式
          document.SaveToFile(outputHtmlPath, FileFormat.Html);
          document.Close();
          Console.WriteLine("转换成功！HTML文件路径：{outputHtmlPath}"); 
        }
    }
}

场景2：从本地 Markdown 文件转换

若 Markdown 内容已保存为本地文件（如 .md 文件），可直接加载文件并转换，代码更简洁：

csharp 复制代码

using Spire.Doc;
using System;

namespace MarkdownFileToHtml
{
    class Program
    {
        static void Main(string[] args)
        {
            // 1. 创建文档实例
            Document markdownDoc = new Document();

            // 2. 加载本地Markdown文件（指定文件路径和格式）
            string inputMdPath = "Input/Test.md";
            markdownDoc.LoadFromFile(inputMdPath, FileFormat.Markdown);

            // 3. 保存为HTML
            string outputHtmlPath = "Output/MarkdownFileToHtml.html";
            markdownDoc.SaveToFile(outputHtmlPath, FileFormat.Html);

            Console.WriteLine("文件转换完成！");
        }
    }
}

三、进阶用法：批量转换多个Markdown文件

若需批量处理文件夹下的所有 .md 文件，可结合文件遍历实现：

csharp 复制代码

using Spire.Doc;
using System.IO;

namespace BatchMarkdownToHtml
{
    class Program
    {
        static void Main(string[] args)
        {
            // 源Markdown文件夹
            string sourceDir = "Input/MarkdownFiles/";
            // 目标HTML文件夹
            string targetDir = "Output/HtmlFiles/";
            if (!Directory.Exists(targetDir))
            {
                Directory.CreateDirectory(targetDir);
            }

            // 遍历所有.md文件
            foreach (string mdFile in Directory.GetFiles(sourceDir, "*.md"))
            {
                // 获取文件名（不含扩展名）
                string fileName = Path.GetFileNameWithoutExtension(mdFile);
                // 目标HTML路径
                string htmlPath = Path.Combine(targetDir, $"{fileName}.html");

                // 执行转换
                Document doc = new Document();
                doc.LoadFromFile(mdFile, FileFormat.Markdown);
                doc.SaveToFile(htmlPath, FileFormat.Html);

                Console.WriteLine($"已转换：{mdFile} → {htmlPath}");
            }

            Console.WriteLine("批量转换完成！");
        }
    }
}

Spire.Doc for .NET 为 C# 开发者提供了极简的 Markdown 转 HTML 解决方案，无需复杂的语法解析逻辑，仅需几行代码即可完成基础转换，同时支持丰富的自定义配置满足个性化需求。该方案可广泛应用于博客系统、文档管理平台、内容发布系统等场景，大幅提升开发效率。