C# में Markdown: लाइब्रेरीज़ और उदाहरण

C# (.NET) में Markdown के साथ काम करना: लाइब्रेरीज़ और टूल्स की समीक्षा

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

C# में Markdown प्रोसेसिंग की आवश्यकता क्यों?

आधुनिक वेब एप्लिकेशन, कंटेंट मैनेजमेंट सिस्टम (CMS) और कोड एडिटर तेज़ी से Markdown को मुख्य इनपुट फ़ॉर्मेट के रूप में अपना रहे हैं। C# (.NET) में यह निम्नलिखित के लिए उपयोगी हो सकता है:

स्टैटिक कंटेंट जनरेट करना (डॉक्यूमेंटेशन, ब्लॉग)
Markdown सपोर्ट के साथ WYSIWYG एडिटर बनाना
बाहरी सिस्टम (GitHub, Reddit, Stack Overflow) से डेटा इम्पोर्ट/एक्सपोर्ट करना
मध्यवर्ती HTML के माध्यम से Markdown को PDF, DOCX या LaTeX में बदलना

C# (.NET) के लिए मुख्य लाइब्रेरीज़

1. Markdig

Markdig .NET में Markdown के साथ काम करने के लिए सबसे लोकप्रिय और उच्च-प्रदर्शन वाली लाइब्रेरी है। यह CommonMark, GFM (GitHub Flavored Markdown) और कई एक्सटेंशन को सपोर्ट करती है: टेबल, टास्क लिस्ट, लिंक ऑटो-रिप्लेसमेंट, गणितीय फ़ॉर्मूले (MathJax के ज़रिए) और भी बहुत कुछ।

इंस्टॉलेशन:

// NuGet Package Manager के ज़रिए
Install-Package Markdig

// या .NET CLI के ज़रिए
dotnet add package Markdig

उपयोग का उदाहरण:

using Markdig;

string markdown = @"
# पहले स्तर का शीर्षक

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

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

> उद्धरण

```csharp
Console.WriteLine(""Hello, World!"");
```";

// GFM एक्सटेंशन के साथ HTML में कन्वर्ट करें
string html = Markdown.ToHtml(markdown);

Console.WriteLine(html);

उन्नत सुविधाएँ:

// अतिरिक्त एक्सटेंशन के साथ पाइपलाइन कॉन्फ़िगर करें
var pipeline = new MarkdownPipelineBuilder()
    .UseAdvancedExtensions() // सभी लोकप्रिय एक्सटेंशन शामिल करें
    .UseMathematics()        // LaTeX फ़ॉर्मूले का सपोर्ट
    .UseEmojiAndSmiley()     // इमोजी :smile:
    .Build();

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

2. CommonMark.NET

CommonMark.NET CommonMark स्पेसिफिकेशन (Markdown मानक) का एक सख्त कार्यान्वयन है। यह लाइब्रेरी हल्की है, इसकी कोई निर्भरता नहीं है, और यह उन प्रोजेक्ट्स के लिए आदर्श है जहाँ रेफरेंस इम्प्लीमेंटेशन के साथ संगतता महत्वपूर्ण है।

इंस्टॉलेशन:

Install-Package CommonMark.NET

उपयोग का उदाहरण:

using CommonMark;

string markdown = "नमस्ते, **दुनिया**!";
string html = CommonMarkConverter.Convert(markdown);

// परिणाम: <p>नमस्ते, <strong>दुनिया</strong>!</p>

3. MarkdownSharp

MarkdownSharp Jeff Atwood (Stack Overflow के सह-संस्थापक) द्वारा मूल Markdown प्रोसेसर का C# पोर्ट है। यह लाइब्रेरी पुरानी हो चुकी है, लेकिन अभी भी पुराने प्रोजेक्ट्स में उपयोग की जाती है। यह बिना किसी एक्सटेंशन के केवल बेसिक सिंटैक्स को सपोर्ट करती है।

Install-Package MarkdownSharp

using MarkdownSharp;

var markdown = new Markdown();
string html = markdown.Transform("**Hello**");

अतिरिक्त टूल्स

4. HtmlSanitizer (सुरक्षित आउटपुट के लिए)

Markdown को HTML में बदलने और फिर वेब पेज पर प्रदर्शित करते समय, परिणाम को संभावित खतरनाक टैग (XSS अटैक) से साफ करना महत्वपूर्ण है। HtmlSanitizer लाइब्रेरी का उपयोग करें:

Install-Package HtmlSanitizer

using Ganss.XSS;

var sanitizer = new HtmlSanitizer();
string rawHtml = Markdown.ToHtml("<script>alert('xss')</script>");
string safeHtml = sanitizer.Sanitize(rawHtml);