Markdown दस्तावेज़ (.md)

CommonMark मानक

मार्कडाउन (MD) दुनिया की सबसे लोकप्रिय हल्की मार्कअप भाषा है, जिसे जॉन ग्रूबर द्वारा सादे पाठ (plain text) के रूप में आसानी से पढ़ने और लिखने योग्य बनाने के लिए डिज़ाइन किया गया था, जबकि यह संरचनात्मक HTML में पूरी तरह से परिवर्तित हो जाती है।

आविष्कर्ता: John Gruber & Aaron Swartzवर्ष: 2004MIME: text/markdown

निरीक्षण और मेटाडेटा

ऑपरेटिंग सिस्टम और फ़ाइल विश्लेषक शुरुआती बाइनरी बाइट अनुक्रम का निरीक्षण करके Markdown फ़ाइलों की पहचान करते हैं:

फ़ाइलें यहाँ चुनें या छोड़ें

निजी - फ़ाइलें कभी आपके डिवाइस से बाहर नहीं जातीं

या पेस्ट करें Ctrl+V
नेटवर्क पर कोई डेटा भेजे बिना गोपनीयता की गारंटी: बाहरी सर्वर पर 0 बाइट अपलोड किए गए। सारी प्रोसेसिंग आपके ब्राउज़र सैन्डबॉक्स में स्थानीय रूप से हुई।

बाइट-स्तरीय हेडर हस्ताक्षर (मैजिक बाइट्स)

ऑपरेटिंग सिस्टम और फ़ाइल विश्लेषक शुरुआती बाइनरी बाइट अनुक्रम का निरीक्षण करके Markdown फ़ाइलों की पहचान करते हैं:

HEX हस्ताक्षर (ऑफ़सेट 0):

कोई निश्चित हस्ताक्षर नहीं

ASCII निरूपण: कोई निश्चित हस्ताक्षर नहीं

मानकीकरण: CommonMark Specification / GitHub Flavored Markdown (GFM)

तकनीकी विनिर्देश

कंटेनर आर्किटेक्चरहल्के विराम-चिह्न फ़ॉर्मैटिंग (शीर्षक, सूचियाँ, बोल्ड, इटैलिक, कोड ब्लॉक) का उपयोग करने वाली सादी UTF-8 पाठ फ़ाइल
कंप्रेशनअसंपीड़ित पाठ (Gzip या Brotli से आसानी से संपीड़ित)
बाइट एंडियानेसUTF-8 / Unicode पाठ धारा
कलर स्पेसलागू नहीं (सादा-पाठ मार्कअप)
चैनल और संरचनाशीर्षक, ब्लॉक उद्धरण, बिना क्रम वाली और क्रमबद्ध सूचियाँ, कोड ब्लॉक, हाइपरलिंक, चित्र और तालिकाएँ।
अधिकतम आयामअसीमित पाठ दस्तावेज़ लंबाई
पारदर्शिताकोई नहीं (शुद्ध पाठ)
स्ट्रीमिंग और प्रोग्रेसिवब्लॉक और इनलाइन टोकनों को पंक्ति-दर-पंक्ति स्ट्रीम करते हुए टोकन में विभाजित करना।

तकनीकी तुलना मैट्रिक्स: Markdown बनाम प्रतियोगी

तकनीकी विशेषताMarkdown (वर्तमान)HTMLTXTPDF
लेखन सरलताअत्यंत तेज़ सादा पाठ टाइपिंगवर्बोज़ टैग सिंटैक्स (<p>, <div>)तेज़ टाइपिंग (कोई फ़ॉर्मेटिंग नहीं)ग्राफ़िकल लेआउट संपादक की आवश्यकता होती है
मानवीय पठनीयता (कच्चा)सहज प्राकृतिक पाठ पठनीयताटैग और ब्रैकेट से अस्त-व्यस्तबेहद साफ़ पाठ पठनीयताबाइनरी अपठनीय कच्चे बाइट्स
HTML रूपांतरणप्रत्यक्ष 1-से-1 नियतात्मक आउटपुटमूल वेब भाषामैनुअल फ़ॉर्मेटिंग की आवश्यकता हैनिश्चित ग्राफ़िकल आउटपुट
डेवलपर टूलिंगसॉफ़्टवेयर के अनुसार समर्थन अलग-अलग होता है।सॉफ़्टवेयर के अनुसार समर्थन अलग-अलग होता है।सॉफ़्टवेयर के अनुसार समर्थन अलग-अलग होता है।दस्तावेज़ वितरण

सामान्य करप्शन मोड और हेक्स रिकवरी गाइड

कोड ब्लॉक सामान्य पैराग्राफ के रूप में प्रस्तुत होते हैं या शीर्षक फ़ॉर्मेट करने में विफल रहते हैं।

मूल कारण: शीर्षक '#' प्रतीक के बाद गायब स्थान या बिना बंद किए गए ट्रिपल-बैकटिक (```) कोड फेंस।

रिकवरी: File2File.app मार्कडाउन लिंटर का उपयोग करके मार्कडाउन सिंटैक्स को सत्यापित और पुनः स्वरूपित करें।

सुरक्षा विश्लेषण और पार्सर अटैक वेक्टर्स

मार्कडाउन कन्वर्टर्स अक्सर डिफ़ॉल्ट रूप से कच्चे इनलाइन HTML की अनुमति देते हैं, जो कि सैनिटाइज़ न किए जाने पर क्रॉस-साइट स्क्रिप्टिंग (XSS) पेश कर सकता है।

ज्ञात अटैक वेक्टर्स

  • मार्कडाउन पाठ के अंदर एम्बेडेड कच्चे HTML तत्वों (जैसे '<script>' या '<img onerror=...>') के माध्यम से XSS इंजेक्शन।
  • गैर-अनुपालन पार्सर्स में गहराई से नेस्टेड ब्लॉककोट या सूची संरचनाओं के माध्यम से सेवा से इनकार (DoS)।
  • मार्कडाउन लिंक सिंटैक्स के अंदर दुर्भावनापूर्ण हाइपरलिंक स्कीमें ('javascript:')।

सुरक्षात्मक सर्वोत्तम प्रथाएँ: DOMPurify का उपयोग करके हमेशा जेनरेट किए गए HTML आउटपुट को सैनिटाइज़ करें और असुरक्षित URL प्रोटोकॉल को अस्वीकार करें।

ऐतिहासिक मूल और मील के पत्थर

2017औपचारिक कॉमनमार्क (CommonMark) विनिर्देश के आधार पर गिटहब फ़्लेवर्ड मार्कडाउन (GFM) का मानकीकरण किया गया।
2014अस्पष्ट मार्कडाउन एज केस को मानकीकृत करने के लिए जेफ एटवुड और जॉन मैकफर्लेन द्वारा कॉमनमार्क पहल शुरू की गई।
2004जॉन ग्रूबर और आरोन श्वार्टज़ ने मूल मार्कडाउन 1.0 विनिर्देश और पर्ल रूपांतरण स्क्रिप्ट जारी की।

मुख्य लाभ और खूबियाँ

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

तकनीकी सीमाएँ और कमियाँ

  • मूल 2004 विनिर्देश में अस्पष्ट पार्सिंग नियम थे, जिससे सूक्ष्म बोली विखंडन (CommonMark बनाम GFM बनाम Kramdown) हुआ।
  • मल्टी-कॉलम पत्रिका लेआउट, टेक्स्ट रैप या पृष्ठ संख्या जैसी जटिल पेज लेआउट सुविधाओं का अंतर्निहित समर्थन नहीं है।
  • एम्बेडेड छवियां दस्तावेज़ फ़ाइल के अंदर संग्रहीत होने के बजाय बाहरी रूप से जुड़ी होती हैं।

रोचक तकनीकी जानकारी

  • आरोन श्वार्टज़, जिन्होंने 17 वर्ष की आयु में जॉन ग्रूबर के साथ मार्कडाउन सह-विकसित किया था, ने रेडिट की सह-स्थापना भी की और RSS 1.0 बनाया।
  • दुनिया की हर एक गिटहब रिपॉजिटरी डेवलपर्स के सामने अपने कोडबेस का परिचय देने के लिए 'README.md' फ़ाइल का उपयोग करती है।
  • मार्कडाउन डिज़ाइन दर्शन बताता है: 'मार्कडाउन के फ़ॉर्मेटिंग सिंटैक्स के लिए सर्वोपरि डिज़ाइन लक्ष्य इसे जितना संभव हो उतना पठनीय बनाना है।'

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

Markdown का उपयोग किस लिए किया जाता है?

Markdown का उपयोग दस्तावेज़ीकरण लिखने, GitHub README फ़ाइलों, ब्लॉग पोस्ट, Obsidian और Notion जैसे ऐप्स में नोट्स लेने और Discord और Slack जैसे प्लेटफ़ॉर्म पर संदेश लिखने के लिए किया जाता है।

मैं Markdown को PDF या HTML में कैसे बदल सकता हूँ?

आप सीधे अपने वेब ब्राउज़र में File2File.app का उपयोग करके एक क्लिक में Markdown (.md) फ़ाइलों को स्टाइल किए गए PDF दस्तावेज़ों या साफ़ HTML कोड में बदल सकते हैं।

GitHub Flavored Markdown (GFM) क्या है?

GFM, Markdown का GitHub का विस्तारित संस्करण है जो तालिकाओं, चेकबॉक्स ([x]) वाली टास्क सूचियों, स्ट्राइकथ्रू (~~text~~), और सिंटैक्स-हाइलाइट किए गए कोड ब्लॉकों के लिए समर्थन जोड़ता है।