顯然,Markdown 很容易學習,而且它使編寫格式化文字變得非常簡單。事實上,您可以輕鬆地將MD 檔案轉換為任何其他流行的檔案格式,例如PDF、DOCX、HTML 等。但是,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 的轉換。它超級快速、高效、安全,並配有拖放式使用者介面。我們強烈建議您體驗這個線上工具,因為它是免費的,不需要任何訂閱。
最後的想法
本博文到此結束。本指南專門針對 .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?
請訪問此連結以了解詳細答案。