मार्कडाउन से HTML

मार्कडाउन से HTML एक मुफ़्त टूल है, जो Markdown स्निपेट को वेबसाइटों, कॉन्टेंट सिस्टम और डेवलपमेंट वर्कफ़्लो में इस्तेमाल करने के लिए रॉ HTML कोड में बदलता है।

मार्कडाउन से HTML क्या-क्या बदलता है?

यह Markdown फ़ॉर्मैटिंग को उससे मेल खाने वाले HTML एलिमेंट में बदलता है। हेडिंग, हेडिंग एलिमेंट बन जाती है, लिंक एंकर एलिमेंट में बदल जाता है और बुलेट वाली सूची, सूची आइटम वाली अनऑर्डर्ड लिस्ट बन जाती है।

Markdown एक प्लेन-टेक्स्ट मार्कअप फ़ॉर्मैट है। इसका इस्तेमाल आम तौर पर README फ़ाइलों, तकनीकी दस्तावेज़ों, समस्या विवरणों और स्टैटिक साइट के कॉन्टेंट में होता है। जब कोई वेबसाइट टेम्पलेट, ईमेल सिस्टम या कॉन्टेंट मैनेजमेंट सिस्टम फ़ील्ड Markdown के बजाय HTML स्वीकार करता हो, तब इसे HTML में बदलना उपयोगी होता है।

Markdown के कई प्रकार हैं। टेबल, टास्क लिस्ट, लाइन ब्रेक और एम्बेड किए गए HTML को संभालने के तरीके में CommonMark, GitHub Flavored Markdown और अलग-अलग ऐप्लिकेशन के पार्सर भिन्न हो सकते हैं। टूल की स्रोत जानकारी में किसी खास प्रकार का उल्लेख नहीं है। इसलिए नतीजे का इस्तेमाल करने से पहले सामान्य हेडिंग, पैराग्राफ, लिंक और सूची से आगे की सिंटैक्स की जांच कर लो।

Markdown को HTML में कैसे बदलें?

Markdown फ़ील्ड में स्रोत टेक्स्ट डालो, कन्वर्ज़न चलाओ और फिर HTML फ़ील्ड में तैयार हुआ कोड पढ़ो या कॉपी कर लो।

1. अधूरा फ़ॉर्मैटिंग मार्कर डालने के बजाय पूरा स्निपेट पेस्ट करो।
2. टेक्स्ट को बदलने के बाद मिले HTML में एलिमेंट की संरचना जांचो।
3. लिंक, नेस्टेड लिस्ट और कोड ब्लॉक को उसी ऐप्लिकेशन में जांचो जिसमें वे दिखाए जाएंगे।
4. अगर गंतव्य पर उपयुक्त CSS पहले से मौजूद नहीं है, तो साइट की स्टाइलिंग अलग से लागू करो।

कन्वर्ज़न सर्वर पर होता है। तुम्हारा इनपुट HTTPS के ज़रिए सर्वर तक जाता है और स्टोर नहीं किया जाता। प्रोसेसिंग के लिए टेक्स्ट तुम्हारे डिवाइस से बाहर जाता है, इसलिए जहां तुम्हारे संगठन की नीति सर्वर पर काम करने वाले टूल के इस्तेमाल की अनुमति नहीं देती, वहां लॉगिन जानकारी, प्राइवेट की या गोपनीय सामग्री सबमिट मत करो।

मिले हुए HTML को कैसे समझें?

नतीजे को ऐसे रॉ HTML कोड के रूप में पढ़ो, जिसके एलिमेंट Markdown की संरचना दिखाते हैं। इसे किसी मौजूदा पेज, टेम्पलेट या कॉन्टेंट फ़ील्ड में रखा जा सकता है, लेकिन यह ज़रूरी नहीं कि इसमें doctype, मेटाडेटा, स्टाइल और स्क्रिप्ट वाला पूरा HTML दस्तावेज़ हो।

एक छोटी हेडिंग का प्लेन-टेक्स्ट इनपुट यह है:

# Release notes

इसका पारंपरिक HTML नतीजा है:

<h1>Release notes</h1>

छोटी सूची का इनपुट यह है:

- Alpha

- Beta

इससे बनी संरचना में दो सूची-आइटम एलिमेंट वाली एक अनऑर्डर्ड लिस्ट होती है:

<ul>

<li>Alpha</li>

<li>Beta</li>

</ul>

Markdown की ज़्यादातर गलतियों से औपचारिक पार्सर त्रुटि नहीं आती। जोड़ी के बिना फ़ॉर्मैटिंग मार्कर, गलत इंडेंटेशन या सूची मार्कर के बाद खाली जगह न होने पर सामग्री सामान्य टेक्स्ट की तरह दिख सकती है। अगर मिला हुआ HTML सही दिखता है, लेकिन उसकी संरचना गलत है, तो आउटपुट एलिमेंट की तुलना दस्तावेज़ की अपेक्षित पदानुक्रम से करो।

• जांचो कि हेडिंग अपेक्षित स्तर इस्तेमाल कर रही हैं और बिना ज़रूरत एक स्तर से दूसरे स्तर पर नहीं जा रही हैं।
• पुष्टि करो कि Markdown स्रोत में नेस्टेड सूची आइटम का इंडेंटेशन एक जैसा है।
• प्रकाशित करने से पहले लिंक के गंतव्य जांचो, खास तौर पर किसी तीसरे पक्ष के कॉन्टेंट को प्रोसेस करते समय।
• फेंस किए गए कोड ब्लॉक ध्यान से जांचो, क्योंकि बंद न किया गया फेंस दस्तावेज़ के बाकी हिस्से को भी अपने भीतर ले सकता है।
• स्रोत में रॉ HTML खोजो, क्योंकि अलग-अलग Markdown इम्प्लीमेंटेशन उसे बनाए रख सकते हैं, एस्केप कर सकते हैं या अस्वीकार कर सकते हैं।

कन्वर्ज़न से जुड़ी अहम बातें

Markdown कन्वर्ज़न टेक्स्ट की मूल भाषा नहीं, बल्कि उसकी संरचना बदलता है। उच्चारण चिह्न वाले अक्षर, गैर-लैटिन लिपियां, संख्याएं और सामान्य विराम चिह्न तैयार हुए एलिमेंट के भीतर टेक्स्ट कॉन्टेंट के रूप में बने रह सकते हैं। HTML के लिए संवेदनशील वर्णों को अगर मार्कअप के बजाय वास्तविक टेक्स्ट के रूप में दिखाना हो, तो उनके लिए एंटिटी एन्कोडिंग की ज़रूरत पड़ सकती है।

स्पेस और खाली पंक्तियां पार्सिंग को प्रभावित कर सकती हैं। आम तौर पर खाली पंक्ति दो पैराग्राफ को अलग करती है, जबकि इंडेंटेशन से नेस्टेड लिस्ट या कोड ब्लॉक बन सकता है। लाइन ब्रेक का व्यवहार भी Markdown के प्रकार के अनुसार बदलता है, इसलिए स्रोत में एक नई पंक्ति से हमेशा HTML में दिखाई देने वाला लाइन ब्रेक नहीं बनता।

खाली इनपुट में बदलने लायक कोई सार्थक दस्तावेज़ संरचना नहीं होती। बहुत लंबे इनपुट को स्थानीय बिल्ड प्रक्रिया में संभालना बेहतर हो सकता है, जहां उसे वर्ज़न कंट्रोल में रखा जा सके, जांचा जा सके और प्रोडक्शन में इस्तेमाल होने वाले उसी पार्सर से लगातार एक जैसा बदला जा सके। कोई भी कन्वर्टर यह तय नहीं कर सकता कि तुम्हारे प्रोजेक्ट के लिए हेडिंग स्तर, लिंक का गंतव्य या सूची का पदानुक्रम अर्थ की दृष्टि से सही है या नहीं।

Markdown को HTML में बदलना कब उपयोगी है?

जब आगे इस्तेमाल होने वाला सिस्टम HTML स्वीकार करता हो, लेकिन स्रोत सामग्री Markdown में लिखी या दी गई हो, तब कन्वर्ज़न उपयोगी है। इसके आम उदाहरण हैं किसी तीसरे पक्ष के दस्तावेज़ को इम्पोर्ट करने से पहले जांचना, स्टैटिक साइट बिल्ड को डीबग करना, केवल HTML स्वीकार करने वाले एडिटर के लिए रिलीज़ नोट तैयार करना या डिप्लॉयमेंट से पहले तैयार हुए मार्कअप की समीक्षा करना।

अगर कॉन्टेंट केवल मशीन को पढ़ना है और Markdown अपने ज़रूरी फ़ॉर्मैट में पहले से सही काम कर रहा है, तो आम तौर पर उसे HTML में बदलने की ज़रूरत नहीं होती। इसी तरह, अगर लेखकों को Markdown में ही काम जारी रखना है, तो वर्कफ़्लो की शुरुआत में कन्वर्ज़न करने से बाद में संपादन मुश्किल हो सकता है।

HTML की संरचना डीबग करते समय उसे मिनिफ़ाई मत करो। पढ़ने योग्य मार्कअप में गलत नेस्टिंग और अनचाहे एलिमेंट आसानी से दिखाई देते हैं। आउटपुट जांच लेने और प्रोडक्शन में भेजने के लिए तैयार होने के बाद, HTML मिनिफायर गैर-ज़रूरी खाली जगह कम कर सकता है।

अक्सर पूछे जाने वाले सवाल

क्या बदले गए HTML में CSS स्टाइल भी शामिल होती है?

HTML संरचना बताता है, जबकि ज़्यादातर प्रस्तुति CSS नियंत्रित करती है। एक ही हेडिंग एलिमेंट अलग-अलग साइटों पर अलग दिख सकता है, क्योंकि उसकी स्टाइल ब्राउज़र, ऐप्लिकेशन या थीम से आती है। Markdown स्रोत से अंतिम रूप तय होने की उम्मीद रखने के बजाय गंतव्य पर CSS जोड़ो या मौजूदा CSS इस्तेमाल करो।

क्या Markdown टेबल और टास्क लिस्ट को भी बदल सकते हैं?

इनका सपोर्ट पार्सर में इस्तेमाल किए गए Markdown के प्रकार पर निर्भर करता है। टेबल और टास्क-लिस्ट चेकबॉक्स सार्वभौमिक Markdown सिंटैक्स नहीं, बल्कि प्रचलित एक्सटेंशन हैं। किसी बड़े दस्तावेज़ में इन पर निर्भर होने से पहले छोटा और प्रतिनिधि नमूना बदलकर मिले हुए एलिमेंट की पुष्टि कर लो।

क्या अविश्वसनीय Markdown को बदलना सुरक्षित है?

अविश्वसनीय Markdown को कन्वर्ज़न के बाद भी अविश्वसनीय कॉन्टेंट ही मानो। पार्सर और गंतव्य के आधार पर एम्बेड किए गए HTML या असुरक्षित लिंक स्कीम को सैनिटाइज़ करना पड़ सकता है। यह कन्वर्टर फ़ॉर्मैट बदलता है, लेकिन केवल कन्वर्ज़न को सुरक्षा फ़िल्टर नहीं समझना चाहिए।

क्या HTML को WordPress या किसी दूसरे CMS में पेस्ट कर सकते हैं?

आम तौर पर हां, बशर्ते एडिटर में HTML या कोड व्यू हो और वह मिले हुए एलिमेंट की अनुमति देता हो। कुछ कॉन्टेंट मैनेजमेंट सिस्टम पेस्ट किए गए मार्कअप को सैनिटाइज़ करते हैं, असमर्थित एट्रिब्यूट हटाते हैं या पैराग्राफ के बीच की खाली जगह बदल देते हैं। कॉन्टेंट का प्रीव्यू देखो और सेव हुआ वर्ज़न भी जांचो, क्योंकि सबमिट करने के बाद CMS उसे बदल सकता है।

मेरा कोड ब्लॉक गलत क्यों दिखाई दे रहा है?

जांचो कि शुरुआती और अंतिम फेंस एक-दूसरे से मेल खाते हैं और अलग-अलग पंक्तियों में हैं। आसपास की सूची का इंडेंटेशन एक जैसा न होने पर इंडेंट किए गए कोड ब्लॉक भी टूट सकते हैं। अगर सिंटैक्स हाइलाइटिंग चाहिए, तो गंतव्य को दिए गए भाषा पहचानकर्ता को समझना होगा और अपनी हाइलाइटिंग स्क्रिप्ट या स्टाइल उपलब्ध करानी होगी।

क्या कन्वर्ज़न के बाद Markdown को संभालकर रखना चाहिए?

अगर Markdown ही संपादन योग्य आधिकारिक स्रोत है, तो उसे संभालकर रखो। तैयार हुआ HTML अलग स्टोर करो या बिल्ड के दौरान उसे दोबारा बनाओ, ताकि बाद के संपादन से दोनों फ़ॉर्मैट अलग न हो जाएं। प्रकाशित करने से पहले लिंक की पुष्टि करो और केवल रॉ कोड पर निर्भर रहने के बजाय फ़्रैगमेंट को वास्तविक गंतव्य में जांचो।