C# (.NET) में Markdown के साथ कार्य: लाइब्रेरीज़ और उदाहरण

C# (.NET) में Markdown के साथ कार्य: सर्वश्रेष्ठ लाइब्रेरीज़ और उपयोग के उदाहरण

Markdown एक हल्की मार्कअप भाषा है जो सरल प्रतीकों का उपयोग करके टेक्स्ट को फ़ॉर्मेट करने की अनुमति देती है। इसका व्यापक रूप से दस्तावेज़ीकरण, README फ़ाइलें, ब्लॉग पोस्ट और फ़ोरम संदेश लिखने के लिए उपयोग किया जाता है। C# (.NET) इकोसिस्टम में Markdown को पार्स करने, रूपांतरित करने और जनरेट करने के लिए कई शक्तिशाली लाइब्रेरीज़ मौजूद हैं। इस लेख में हम मुख्य उपकरणों पर विचार करेंगे और दिखाएंगे कि उनके साथ कैसे काम करना है।

C# में Markdown के साथ काम करने के लिए लोकप्रिय लाइब्रेरीज़

.NET में सबसे अधिक मांग वाले समाधान:

• Markdig — आधुनिक, तेज़ और CommonMark विनिर्देश के साथ पूरी तरह से संगत लाइब्रेरी। एक्सटेंशन (तालिकाएँ, स्ट्राइकथ्रू, इमोजी, आरेख आदि) का समर्थन करती है।
• MarkdownSharp — Stack Overflow का हल्का पार्सर। सरल है, लेकिन CommonMark और कई एक्सटेंशन का समर्थन नहीं करता।
• CommonMark.NET — CommonMark विनिर्देश का आधिकारिक कार्यान्वयन। सख्त संगतता के लिए उपयुक्त है।

इस गाइड में हम Markdig पर ध्यान केंद्रित करेंगे, क्योंकि यह आधुनिक .NET प्रोजेक्ट्स के लिए डी-फैक्टो मानक है।

Markdig की स्थापना

NuGet Package Manager या .NET CLI के माध्यम से पैकेज जोड़ें:

dotnet add package Markdig

या Package Manager Console के माध्यम से:

Install-Package Markdig

मूल उपयोग: Markdown को HTML में रूपांतरित करना

सबसे सरल परिदृश्य — Markdown स्ट्रिंग को HTML में बदलना। Markdig इसे एक पंक्ति में करता है:

using Markdig;

string markdown = "# शीर्षक 1

यह **बोल्ड टेक्स्ट** और *इटैलिक* है।

- सूची आइटम 1- सूची आइटम 2";

string html = Markdown.ToHtml(markdown);

Console.WriteLine(html);

परिणाम:

<h1>शीर्षक 1</h1><p>यह <strong>बोल्ड टेक्स्ट</strong> और <em>इटैलिक</em> है।</p><ul><li>सूची आइटम 1</li><li>सूची आइटम 2</li></ul>

Markdig एक्सटेंशन के साथ कार्य

Markdig कई एक्सटेंशन का समर्थन करता है। उनका उपयोग करने के लिए, एक pipeline बनाना होगा:

using Markdig;using Markdig.Extensions.Tables;

var pipeline = new MarkdownPipelineBuilder()    .UseAdvancedExtensions() // सभी मुख्य एक्सटेंशन शामिल करता है    .Build();

string markdown = "| शीर्षक 1 | शीर्षक 2 ||-------------|-------------|| सेल 1    | सेल 2    |";

string html = Markdown.ToHtml(markdown, pipeline);

Console.WriteLine(html);

यह कोड एक HTML तालिका उत्पन्न करेगा। आप अलग-अलग एक्सटेंशन जोड़ सकते हैं: .UseTables(), .UseEmojiAndSmiley(), .UseTaskLists() और अन्य।

HTML को वापस Markdown में रूपांतरित करना

उल्टा रूपांतरण (HTML → Markdown) Markdig की मानक आपूर्ति में शामिल नहीं है, लेकिन ReverseMarkdown लाइब्रेरी का उपयोग किया जा सकता है:

dotnet add package ReverseMarkdown

using ReverseMarkdown;

var converter = new Converter();string html = "<h1>नमस्ते, दुनिया!</h1><p>यह <strong>महत्वपूर्ण</strong> है</p>";string markdown = converter.Convert(html);

Console.WriteLine(markdown);

Markdown फ़ाइलों के साथ कार्य

अक्सर Markdown फ़ाइलों में संग्रहीत होता है। पढ़ने और रूपांतरण का उदाहरण:

using Markdig;

string filePath = "document.md";string markdownContent = File.ReadAllText(filePath);string htmlContent = Markdown.ToHtml(markdownContent);

File.WriteAllText("output.html", htmlContent);

कस्टम pipeline के साथ विस्तारित HTML बनाना

आप विशिष्ट कार्यों के लिए pipeline को बारीकी से ट्यून कर सकते हैं:

var pipeline = new MarkdownPipelineBuilder()