在 C# 中将 Markdown 转换为 HTML - Markdown Conversion API

显然,Markdown 很容易学习,并且它使编写格式化文本变得非常简单。事实上,您可以轻松地将 MD 文件转换为任何其他流行的文件格式,例如 PDFDOCXHTML 等。但是,GorupDocs.Conversion提供多种编程语言的 SDK,以编程方式转换和操作各种文件格式。此外,您可以使用 GorupDocs.Conversion 提供的 REST API。因此,在这篇博文中,我们将学习如何使用 GorupDocs.Conversion Cloud SDK for .NET 在 C# 中将 Markdown 转换为 HTML。此外,还有一个由 GorupDocs.Conversion Cloud SDKs 提供支持的 在线 MD 到 HTML 转换器。

我们将在本文中介绍以下几点:

Markdown 转换 API 安装

GorupDocs.Conversion Cloud SDK for .NET 提供企业级基于云的解决方案,幸运的是,它非常易于安装和设置。那么,您可以通过下载此 NuGet Package 来安装此 HTML 文件生成器库,或者您可以在 NuGet Package manager 中运行以下命令:

Install-Package GroupDocs.Conversion-Cloud -Version 23.10.0

在 C# 中将 Markdown 转换为 HTML

成功安装后,下一步是获取 API 凭据。同样,它非常直接,您可以从 API Cloud 仪表板 获取您的应用程序客户端 ID 和客户端密钥。尽管如此,您可以访问我们的指南,了解如何获取此 Markdown 转换 API 的 API 凭据。

在编写代码片段之前的最后一件事,请注意我们的 API Cloud 仪表板上已经有一个源 Markdown 文件。但是,您可以通过调用此 HTML 文件生成器库的 UploadFile 方法来自动执行文件上传任务。

现在,按照以下步骤以编程方式将 Markdown 转换为 HTML:

  • 初始化 Configuration 类的实例并使用客户端密钥和客户端 ID 对其进行初始化。
  • 定义 ApiBaseUrl 的值以设置 Markdown 转换 API 的基本 URL。
  • 使用 Configuration 类的对象创建 ConvertApi 类的对象。
  • 实例化 ConvertSettings 类的实例,并通过设置 FilePath、Format 和 OutputPath 等值来初始化它。
  • ConvertDocument 方法将以编程方式将 Markdown 转换为 HTML。

以下代码示例将 MD 转换为 C# 中的 HTML:

using System;
using GroupDocs.Conversion.Cloud.Sdk.Api;
using GroupDocs.Conversion.Cloud.Sdk.Client;
using GroupDocs.Conversion.Cloud.Sdk.Model.Requests;
using System.IO;
using GroupDocs.Conversion.Cloud.Sdk.Model;

namespace GroupDocs.Conversion.CSharp
{
    // 在 C# 中将 Markdown 转换为 HTML
    class Convert_MD_to_HTML

    {
        static void Main(string[] args)
        {

            try
            {
                // 获取您的 API 凭证 
                string clientId = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
                string clientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
                string myStorage = "test";

                // 初始化 Configuration 类的实例并使用客户端密钥和客户端 ID 对其进行初始化。 
                var configuration = new Configuration(clientId, clientSecret);
                // 定义 ApiBaseUrl 的值以设置 Markdown 转换 API 的基本 url。
                configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

                // 使用 Configuration 类的对象创建 ConvertApi 类的对象。
                var apiInstance = new ConvertApi(configuration);
                // 实例化 ConvertSettings 类的实例,并通过设置 FilePath、Format 和 OutputPath 等值来初始化它。
                var settings = new ConvertSettings
                {
                    FilePath = "sample.md",
                    Format = "html",
                    OutputPath = "test/sample.html"
                };

                // ConvertDocument 方法将以编程方式将 Markdown 转换为 HTML。
                var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
                Console.WriteLine("Successfully converted Markdown to HTML in C#: " + response[0].Url);
            }
            catch (Exception e)
            {
                Console.WriteLine("Exception when calling GroupDocs.Conversion Api: " + e.Message);
            }

        }
    }
}

生成的 HTML 文件将在 API Cloud 仪表板 的“test”文件夹中生成。因此,您可以通过调用此 Markdown 转换 API 的 DownloadFile 方法来手动或以编程方式下载文件

在线 MD 到 HTML 转换器

到目前为止,我们已经学习了如何在 .NET 应用程序中以编程方式将 Markdown 转换为 HTML。接下来,我们可以使用基于浏览器的在线 Markdown 到 HTML 转换器自动执行 MD 到 HTML 的转换。它超级快速、高效、安全,并配有拖放式用户界面。我们强烈建议您体验这个在线工具,因为它是免费的,不需要任何订阅。

在线 rar 到 png 转换器

最后的想法

本博文到此结束。本指南专门针对 .NET 开发人员,但您可以找到多种流行编程语言的 GorupDocs.Conversion Cloud SDK。因此,您可以使用任何编程语言为您的业务应用程序开发 MD 到 HTML 转换器模块。我们希望您已经学会了如何在 C# 中将 Markdown 转换为 HTML,并且您可以访问文档以了解其他功能。最重要的是,您可以此处与我们的实时云 API 进行交互。此外,您可以克隆我们的 GitHub 存储库以自定义此 .NET 包装器,在此之前,您应该浏览我们的入门指南

最后,groupdocs.cloud 正在撰写新的博客文章。因此,请保持联系以获取定期更新。

问一个问题

您可以在我们的论坛上告诉我们您的问题或疑问。

常见问题 – 常见问题解答

如何将 Markdown 文件转换为 HTML?

您可以使用这个基于 Web 的在线工具将 MD 转换为 HTML,该工具由 GorupDocs.Conversion Cloud SDKs 提供支持。

如何在 Visual Studio 中从 Markdown 生成 HTML?

请访问此链接以了解详细答案。

也可以看看