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

CommonMark मानक

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

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

इंस्पेक्ट और मेटाडेटा

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

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

100% प्राइवेट इन-ब्राउज़र कन्वर्शन - फ़ाइलें कभी आपका डिवाइस नहीं छोड़तीं

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

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

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

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

23 20 / 2D 2D 2D

ASCII निरूपण: # / ---

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

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

कंटेनर आर्किटेक्चरPlain UTF-8 text file utilizing lightweight punctuation formatting (headings, lists, bold, italics, code blocks)
कंप्रेशनUncompressed text (readily compressed with Gzip or Brotli)
बाइट एंडियानेसUTF-8 / Unicode text stream
कलर स्पेसN/A (Plaintext Markup)
चैनल और संरचनाHeadings, blockquotes, unordered/ordered lists, code fences, hyperlinks, images, and tables
अधिकतम आयामUnbounded text document length
पारदर्शिता (Transparency)None (pure text)
स्ट्रीमिंग और प्रोग्रेसिवStreaming line-by-line block and inline tokenization

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

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

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

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

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

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

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

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

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

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

सुरक्षात्मक सर्वोत्तम प्रथाएँ:

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

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

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

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

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

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

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

  • आरोन श्वार्टज़, जिन्होंने 17 वर्ष की आयु में जॉन ग्रuber के साथ मार्कडाउन सह-विकसित किया था, ने रेडिट की सह-स्थापना भी की और 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~~), और सिंटैक्स-हाइटलाइटेड कोड ब्लॉकों के लिए समर्थन जोड़ता है।