यह क्या करता है
Markdown से HTML कन्वर्टर Markdown टेक्स्ट को HTML मार्कअप में बदलता है, जिसे आप CMS, ईमेल टेम्पलेट, स्टैटिक पेज या ऐसी किसी भी जगह पेस्ट कर सकते हैं जो HTML लेती है पर Markdown नहीं। यह README को वेबसाइट पर प्रकाशित करने, नोट्स को ब्लॉग एडिटर में ले जाने, या यह जाँचने में काम आता है कि Markdown का कोई टुकड़ा ठीक-ठीक कौन-से टैग बनाता है।
आउटपुट वही HTML है जो लोकप्रिय Markdown रेंडरर बनाते हैं: <h1> से <h6> तक हेडिंग, <p> पैराग्राफ़, <ul> और <ol> सूचियाँ, सिंटैक्स हाइलाइटर के लिए language- क्लास वाले <pre><code> ब्लॉक, और GitHub-स्टाइल टेबल के लिए <table> मार्कअप।
इस्तेमाल कैसे करें
- Markdown टाइप या पेस्ट करें,
.mdफ़ाइल अपलोड करें या उदाहरण पर क्लिक करें। - ज़रूरी विकल्प चुनें: GitHub Flavored Markdown, लाइन ब्रेक को
<br>बनाना, एंकर लिंक के लिए हेडिंग ID, अविश्वसनीय इनपुट के लिए सैनिटाइज़, और टुकड़े के बजाय पूरा HTML डॉक्यूमेंट। - HTML कॉपी करें या
.htmlफ़ाइल के रूप में डाउनलोड करें।
नतीजा टाइप करते-करते अपडेट होता है। नतीजे को किसी मौजूदा पेज में पेस्ट करते समय पूरा डॉक्यूमेंट विकल्प बंद रखें, और अलग फ़ाइल चाहिए हो तो उसे चालू करें।
उदाहरण
यह Markdown:
## Install
Run the **installer** and read the [guide](https://example.com).
- Windows
- macOSइस HTML में बदल जाता है:
<h2>Install</h2>
<p>Run the <strong>installer</strong> and read the <a href="https://example.com">guide</a>.</p>
<ul>
<li>Windows</li>
<li>macOS</li>
</ul>सुझाव
- डिफ़ॉल्ट रूप से Markdown के अंदर का रॉ HTML जैसा है वैसा रहता है, जैसा ज़्यादातर रेंडरर करते हैं। जब भी Markdown किसी और ने लिखा हो, सैनिटाइज़ चालू करें।
- हेडिंग ID चालू होने पर आप
page.html#installजैसे पते से किसी सेक्शन को लिंक कर सकते हैं और हेडिंग से विषय-सूची बना सकते हैं। - कोड ब्लॉक अपनी भाषा को क्लास के रूप में रखते हैं, इसलिए Prism या highlight.js जैसे हाइलाइटर बिना अतिरिक्त काम के उन्हें पहचान लेते हैं।
- रेंडर किया गया नतीजा साथ-साथ देखने के लिए Markdown प्रीव्यू इस्तेमाल करें। उल्टी दिशा के लिए HTML से Markdown कन्वर्टर है।
अक्सर पूछे जाने वाले सवाल
› कौन-सा Markdown सिंटैक्स समर्थित है?
पूरा CommonMark, जैसे हेडिंग, ज़ोर, लिंक, इमेज, सूचियाँ, ब्लॉककोट, कोड और क्षैतिज रेखाएँ। GitHub Flavored Markdown चालू करने पर कॉलम अलाइनमेंट वाली टेबल, टास्क लिस्ट, स्ट्राइकथ्रू और खाली URL के लिए अपने-आप लिंक भी मिलते हैं।
› सैनिटाइज़ विकल्प क्या करता है?
यह Markdown के सारे रॉ HTML को एस्केप करता है ताकि वह टैग बनने के बजाय टेक्स्ट की तरह दिखे, और उन लिंक व इमेज को हटा देता है जिनका URL javascript या vbscript जैसी असुरक्षित स्कीम इस्तेमाल करता है। जब Markdown ऐसे यूज़र से आए जिन पर आपको भरोसा नहीं, जैसे कमेंट या फ़ोरम पोस्ट, तब इसे चालू करें।
› हेडिंग ID कैसे बनते हैं?
ठीक वैसे ही जैसे GitHub बनाता है। हेडिंग का टेक्स्ट छोटे अक्षरों में बदला जाता है, विराम चिह्न हटाए जाते हैं और स्पेस हाइफ़न बन जाते हैं, इसलिए Getting Started को id getting-started मिलता है। दोहराई गई हेडिंग को -1, -2 आदि मिलते हैं, जिससे हर एंकर अनोखा रहता है।
› पूरा HTML डॉक्यूमेंट विकल्प किसलिए है?
यह नतीजे को एक पूरे पेज में लपेटता है जिसमें doctype, UTF-8 कैरेक्टर सेट, viewport टैग, पहली लेवल-एक हेडिंग से लिया गया title और पढ़ने में आसान छोटी स्टाइलशीट होती है। इसे .html फ़ाइल के रूप में सेव करें और यह किसी भी ब्राउज़र में ठीक से खुलेगा।
› क्या मेरा Markdown कहीं भेजा जाता है?
नहीं। कन्वर्ज़न आपके ब्राउज़र में marked लाइब्रेरी से होता है और कुछ भी सर्वर पर अपलोड नहीं होता।