在 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?

請訪問此連結以了解詳細答案。

也可以看看