संक्षिप्त तुलना
मार्कडाउन तब चुनें जब लेखन गति, पठनीय स्रोत, पोर्टेबिलिटी और वर्ज़न-कंट्रोल डिफ़ सबसे अधिक मायने रखते हों। HTML तब चुनें जब दस्तावेज़ को ऐसे सिमेंटिक्स या घटकों की आवश्यकता हो जो मार्कडाउन व्यक्त नहीं कर सकता, या जब आप सीधे रेंडर किए गए वेब पेज के स्वामी हों।
| चिंता | मार्कडाउन | HTML |
|---|---|---|
| स्रोत पठनीयता | सामान्य दस्तावेज़ों के लिए उच्च | सामग्री के आस-पास अधिक मार्कअप |
| प्रस्तुति नियंत्रण | रेंडरर को सौंपा गया | CSS के साथ विस्तृत नियंत्रण |
| दस्तावेज़ शब्दावली | छोटी और दृढ़ | व्यापक सिमेंटिक एलिमेंट समूह |
| पोर्टेबिलिटी | सामान्य सिंटैक्स में मजबूत | वेब पर मजबूत |
| इंटरैक्टिविटी | आमतौर पर नहीं | स्क्रिप्ट और घटकों के साथ संभव |
| सुरक्षा सतह | रेंडरर-निर्भर | सक्रिय सामग्री को सख्त नियंत्रण की आवश्यकता होती है |
मार्कडाउन कहाँ अधिक मजबूत है
मार्कडाउन लेखकों को दस्तावेज़ के पदानुक्रम और शब्दों पर केंद्रित रखता है। एक शीर्षक शीर्षक ही होता है, बिना क्लास नाम, स्पेसिंग टोकन या रिस्पॉन्सिव ब्रेकपॉइंट के निर्णयों के। इससे नियमित तकनीकी लेखन तेज़ और समीक्षा डिफ़ शांत होते हैं।
इसका व्यापार-नाप यह है कि रेंडरर का अंतिम कहना होता है। एक ही टेबल या टास्क लिस्ट GitHub, एडिटर और स्टैटिक-साइट जनरेटर में अलग दिख सकती है, और कुछ एक्सटेंशन हर जगह मौजूद नहीं हो सकते।
HTML कहाँ अधिक मजबूत है
HTML नेविगेशन, फ़िगर, डिटेल पैनल, फ़ॉर्म, परिभाषाएँ, मीडिया और समृद्ध एक्सेसिबिलिटी संबंधों को दर्शा सकता है जो मूल मार्कडाउन नहीं कर सकता। CSS के साथ मिलकर यह सटीक लेआउट और डिज़ाइन सिस्टम का समर्थन करता है।
यह शक्ति ज़िम्मेदारी भी जोड़ती है। लेखकों या घटक प्रणालियों को वैध सिमेंटिक्स, कीबोर्ड-अनुकूल इंटरैक्शन, रिस्पॉन्सिव शैली और सुरक्षित सामग्री सीमा बनानी होती है। अविश्वसनीय दस्तावेज़ से रॉ HTML बिना सैनिटाइज़ेशन के कभी इंजेक्ट नहीं होना चाहिए।
अधिकांश दस्तावेज़ीकरण प्रणालियाँ दोनों का उपयोग करती हैं
एक सामान्य पाइपलाइन लेखों को मार्कडाउन के रूप में संग्रहीत करती है, उन्हें HTML में बदलती है, फिर साझा घटक और CSS लागू करती है। लेखकों को पठनीय स्रोत मिलता है जबकि वेबसाइट को नेविगेशन, सिंटैक्स हाइलाइटिंग, रिस्पॉन्सिव लेआउट और एक्सेसिबिलिटी सुविधाएँ मिलती हैं।
कुछ प्रणालियाँ मार्कडाउन के अंदर रॉ HTML की अनुमति देती हैं। उस एस्केप हैच का कम उपयोग करें: यह पोर्टेबिलिटी घटाता है और सुरक्षा सतह बढ़ा सकता है। जब प्रकाशन प्लेटफ़ॉर्म प्रदान करता है तो एक प्रलेखित घटक या एक्सटेंशन चुनें।
Markdown: ## API reference [Read the schema](/schema) HTML: <h2>API reference</h2> <a href="/schema">Read the schema</a>
HTML को मार्कडाउन में बदलना जानबूझकर नुकसानदेह है
सिमेंटिक शीर्षक, पैराग्राफ, लिंक, सूचियाँ, कोड और सरल टेबल के स्पष्ट समकक्ष होते हैं। CSS लेआउट, क्लास नाम, स्क्रिप्ट, फ़ॉर्म और कस्टम विजेट के नहीं होते। एक अच्छा रूपांतरण पठनीय दस्तावेज़ रखता है और वेब एप्लिकेशन को पीछे छोड़ देता है।
रूपांतरण के बाद सापेक्ष लिंक, इमेज संदर्भ, कोड फ़ेंस और किसी भी रॉ खंड का निरीक्षण करें। एडिटर पूर्वावलोकन को अविश्वसनीय आउटपुट को सैनिटाइज़ करना चाहिए, लेकिन प्रकाशन अब भी अपनी स्वयं की सामग्री नीति का हकदार है।