Markdown एक हल्का पाठ स्वरूपण वाक्यविन्यास है जो सादे पाठ को संरचित दस्तावेजों में परिवर्तित करता है. 2004 में जॉन ग्रुबर द्वारा बनाया गया, यह अब प्रलेखन, README फ़ाइलों, ब्लॉग पोस्ट और डेवलपर संचार के लिए मानक प्रारूप है। यह मार्गदर्शिका बताती है कि Markdown क्या है, लोग इसका उपयोग क्यों करते हैं, और कैसे शुरू किया जाए।
Markdown क्या है?
Markdown सरल विरामचिन्ह वर्णों का उपयोग करके सादे पाठ में स्वरूपण जोड़ने का एक तरीका है. आप टेक्स्ट एडिटर में लिखते हैं, और Markdown को एक प्रोसेसर द्वारा स्वरूपित आउटपुट (HTML, PDF, आदि) में प्रस्तुत किया जाता है.
उदाहरण के लिए:
# This is a Heading
This is a **bold word** and this is *italic*.
- List item one
- List item twoइस प्रकार प्रस्तुत करता है:
यह एक शीर्षक है
यह एक बोल्ड __पी_ए__ और यह है italic.
- सूची का प्रथम बिंदु
- सूची का दूसरा बिंदु
प्रारूपण स्वयं पाठ में रहता है कोई छिपा हुआ एक्सएमएल, कोई बाइनरी प्रारूप, कोई मालिकाना एन्कोडिंग नहीं।
Markdown क्यों बनाया गया था?
मार्कडाउन से पहले, वेब लेखकों को एक विकल्प का सामना करना पड़ाः कच्चे एचटीएमएल में लिखें (कठिन और त्रुटि-प्रवण) या एक WYSIWYG संपादक का उपयोग करें जो गन्दा कोड उत्पन्न करता है। जॉन ग्रूबर ने __पी_ए__ को डिजाइन किया है:
- यथास्थिति में पठनीय बिना रेंडर के भी,
**bold**जोर के रूप में स्पष्ट रूप से पढ़ता है - किसी के द्वारा भी लिखा जा सकता है कोई विशेष सॉफ़्टवेयर नहीं, बस एक पाठ संपादक
- HTML में परिवर्तनीय प्राथमिक आउटपुट प्रारूप
मूल विनिर्देश स्वच्छ HTML के उत्पादन पर केंद्रित था। लेकिन Markdown तब से दर्जनों प्लेटफार्मों और आउटपुट प्रारूपों में फैल गया है।
Markdown का उपयोग कहाँ किया जाता है?
Markdown प्रौद्योगिकी में हर जगह है:
| मंच | Markdown क्या करता है |
|---|---|
| GitHub | README, मुद्दे, खींचने के अनुरोध, विकी |
| Notion | पृष्ठ सामग्री और दस्तावेज |
| Obsidian | सभी नोटों को सुरक्षित रखा गया है। |
| वर्डप्रेस | Markdown प्लगइन के माध्यम से पोस्ट |
| GitBook | प्रलेखन पृष्ठ |
| सुस्ती / असहमति | संदेश स्वरूपण |
| स्टैक ओवरफ्लो | प्रश्न और उत्तर |
| जेकिल / ह्यूगो / एस्ट्रो | ब्लॉग पोस्ट और स्थैतिक पृष्ठ |
| जुपिटर नोटबुक | प्रलेखन कक्ष |
यदि आप कोई तकनीकी सामग्री लिखते हैं, तो आपको लगभग निश्चित रूप से Markdown का सामना करना पड़ा है।
__पी_ए__ बनाम Word: मुख्य अंतर
| पहलू | Word | Markdown |
|---|---|---|
| प्रारूप | द्विआधारी (.docx) | सादा पाठ (.md) |
| पोर्टेबिलिटी | Word या संगत ऐप की आवश्यकता है | किसी भी पाठ संपादक में खोला जाता है |
| संस्करण नियंत्रण | कठिन (बाइनरी डिफ़्स) | आसान (लाइन-बाय-लाइन गिट भिन्नताएँ) |
| प्रतिपादन | ऐप में अंतर्निहित | Markdown रेंडरर की आवश्यकता है |
| सीखने की वक्र | WYSIWYG (कोई सीख नहीं) | वाक्यविन्यास सीखने की आवश्यकता है |
| मंच सहायता | माइक्रोसॉफ्ट पारिस्थितिकी तंत्र | सार्वभौमिक डेवलपर उपकरण |
यदि आपके पास Word दस्तावेज़ हैं जिन्हें आप Markdown में परिवर्तित करना चाहते हैं, WordToMD इसे तुरंत संभालता है कोई पंजीकरण नहीं, कोई अपलोड नहीं।
मूल Markdown वाक्यविन्यास
यहाँ सबसे आम तत्व दिए गए हैं:
शीर्षक
# Heading 1
## Heading 2
### Heading 3देखें Markdown शीर्षक गाइड पूर्ण संदर्भ के लिए।
ज़ोर देना
**Bold text**
*Italic text*
~~Strikethrough~~सूचियाँ
- Unordered item
- Another item
- Nested item
1. First
2. Second
3. Thirdलिंक्स
[Link text](https://example.com)चित्र
कोड
Inline: `code snippet`
Block:
```python
print("Hello, Markdown!")
See [Markdown Code Blocks Guide](/blog/markdown-code-blocks-guide).
### Tables
```markdown
| Name | Role |
|---|---|
| Alice | Developer |
| Bob | Designer |देखें Markdown तालिकाएँ: एक पूर्ण मार्गदर्शिका.
ब्लॉकक्वाट
> This is a blockquote.
> It can span multiple lines.Markdown स्वाद
Markdown एक मानक नहीं है इसके कई रूप हैं:
- CommonMark एक सख्त, स्पष्ट विनिर्देश
- GitHub स्वादित Markdown (GFM) CommonMark + तालिकाएँ, कार्य सूची, स्ट्राइकथ्रू, ऑटोलिंक
- मल्टीमार्कडाउन फुटनोट, उद्धरण, मेटाडेटा जोड़ता है
- __पी_बी__ __पी_ए__ Pandoc कनवर्टर द्वारा प्रयोग किया जाने वाला सबसे अधिक सुविधा संपन्न
अधिकांश प्लेटफार्म कम से कम CommonMark का समर्थन करते हैं. GitHub, Obsidian, और GitBook GFM का उपयोग करते हैं। पूर्ण संदर्भ के लिए, देखें __पी_बी__ वाक्यविन्यास __पी_ए__.
कैसे लिखें Markdown
आपको विशेष सॉफ़्टवेयर की आवश्यकता नहीं है। विकल्पों में शामिल हैंः
- वी एस कोड अंतर्निहित Markdown पूर्वावलोकन के साथ निःशुल्क, शक्तिशाली संपादक
- Obsidian Markdown ग्राफ दृश्य के साथ नोट लेने वाला ऐप
- टाइपोरा WYSIWYG Markdown संपादक
- आईए लेखक केंद्रित लेखन वातावरण
- कोई भी सादा पाठ संपादक नोटपैड, टेक्स्टएडिट, विम, ईमैक्स
Markdown और अन्य प्रारूपों के बीच परिवर्तित करना
यदि आपके पास Word दस्तावेज़ हैं जिन्हें Markdown में परिवर्तित करना है, WordToMD यह सेकंड में करता है पूरी तरह से मुफ्त, कोई फ़ाइल अपलोड के साथ.
रिवर्स (Markdown से Word या PDF) के लिए, Pandoc जैसे उपकरण इस रूपांतरण को संभालते हैं। देखें __पी_बी__ __पी_सी__ से __पी_ए__ सेटअप निर्देशों के लिए।
FAQ
क्या Markdown एक प्रोग्रामिंग भाषा है? नहीं, नहीं। Markdown एक मार्कअप भाषा है यह स्वरूपण का वर्णन करती है, न कि तर्क या गणना।
क्या मैं Markdown को Microsoft Word में उपयोग कर सकता हूँ? Word Markdown को देशी रूप से रेंडर नहीं करता है, लेकिन Word ऐड-इन हैं जो Markdown समर्थन जोड़ते हैं. वैकल्पिक रूप से, Word को Markdown में परिवर्तित करें WordToMD और Markdown एडिटर का उपयोग करें.
क्या Markdown लम्बे दस्तावेजों के लिए अच्छा है? हाँ, अच्छी दिशा संरचना के साथ। बहुत लम्बे दस्तावेज़ कई फ़ाइलों में विभाजित होने से लाभान्वित होते हैं (जैसे GitBook या Obsidian वॉल्ट में) ।
Markdown किस फ़ाइल एक्सटेंशन का उपयोग करता है?
.md मानक है। .markdown भी मान्य है। कुछ प्लेटफार्मों का उपयोग .mdx JSX (React) घटकों के साथ Markdown के लिए।
निष्कर्ष
Markdown एक सरल, शक्तिशाली प्रारूप है जो तकनीकी लेखन की भाषा बन गया है। यह सादे पाठ के रूप में पठनीय है, सुंदर रूप से प्रस्तुत करता है, और प्रत्येक प्रमुख डेवलपर टूल के साथ काम करता है। यदि आप इसके लिए नए हैं, तो इसके साथ शुरू करें __पी_बी__ वाक्यविन्यास __पी_ए__ और अपने पहले Word दस्तावेज़ में परिवर्तित करने की कोशिश WordToMD.