Markdown सिंटेक्स चीटशीट: शुरुआती से उन्नत तक

परिचय

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

मूलभूत सिंटेक्स

शीर्षक (Headings)

Markdown छह स्तरों के शीर्षकों का समर्थन करता है, # सिंबल का उपयोग करके:

# पहले स्तर का शीर्षक
## दूसरे स्तर का शीर्षक
### तीसरे स्तर का शीर्षक
#### चौथे स्तर का शीर्षक
##### पांचवें स्तर का शीर्षक
###### छठे स्तर का शीर्षक

आप अंडरलाइन फॉर्म का भी उपयोग कर सकते हैं (केवल पहले और दूसरे स्तर के लिए):

पहले स्तर का शीर्षक
========

दूसरे स्तर का शीर्षक
--------

पैराग्राफ और लाइन ब्रेक

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

यह पहला पैराग्राफ है।

यह दूसरा पैराग्राफ है।

यह एक लाइन है  
यह अगली लाइन है (पिछली लाइन के अंत में दो स्पेस पर ध्यान दें)

टेक्स्ट फॉर्मेटिंग

प्रभाव	सिंटेक्स	उदाहरण
बोल्ड	**टेक्स्ट** या __टेक्स्ट__	बोल्ड टेक्स्ट
इटैलिक	*टेक्स्ट* या _टेक्स्ट_	इटैलिक टेक्स्ट
बोल्ड इटैलिक	***टेक्स्ट*** या ___टेक्स्ट___	बोल्ड इटैलिक टेक्स्ट
स्ट्राइकथ्रू	~~टेक्स्ट~~	स्ट्राइकथ्रू टेक्स्ट
अंडरलाइन	<u>टेक्स्ट</u>	अंडरलाइन टेक्स्ट

सूचियां

अनऑर्डर्ड लिस्ट

-, + या * का उपयोग करके अनऑर्डर्ड लिस्ट बनाएं:

- आइटम एक
- आइटम दो
  - सब-आइटम 2.1
  - सब-आइटम 2.2
- आइटम तीन

+ प्लस का भी उपयोग कर सकते हैं
* या एस्टरिस्क का

ऑर्डर्ड लिस्ट

नंबर और डॉट का उपयोग करके ऑर्डर्ड लिस्ट बनाएं:

1. पहला आइटम
2. दूसरा आइटम
   1. सब-आइटम 2.1
   2. सब-आइटम 2.2
3. तीसरा आइटम

टास्क लिस्ट

GitHub स्टाइल टास्क लिस्ट:

- [x] पूरा हो चुका टास्क
- [ ] शेष काम
- [ ] कोई और शेष काम

लिंक

इनलाइन लिंक

[लिंक टेक्स्ट](https://www.example.com)
[टाइटल के साथ लिंक](https://www.example.com "लिंक टाइटल")

रेफरेंस लिंक

[लिंक टेक्स्ट][रेफरेंस आईडी]

[रेफरेंस आईडी]: https://www.example.com "वैकल्पिक टाइटल"

ऑटो लिंक

<https://www.example.com>
<[email protected]>

इमेज

![वैकल्पिक टेक्स्ट](इमेज_URL)
![टाइटल के साथ इमेज](इमेज_URL "इमेज टाइटल")

रेफरेंस स्टाइल इमेज:
![वैकल्पिक टेक्स्ट][इमेज रेफरेंस]

[इमेज रेफरेंस]: इमेज_URL "वैकल्पिक टाइटल"

कोटस

> यह एक कोट है
> यह कई लाइनों में हो सकता है
> 
> > नेस्टेड कोट भी बना सकते हैं

कोड

इनलाइन कोड

इनलाइन कोड के लिए `बैकटिक्स` का उपयोग करें

कोड ब्लॉक

तीन बैकटिक्स या चार स्पेस इंडेंटेशन का उपयोग करें:

```javascript
function hello() {
    console.log("Hello, World!");
}
```

    या इंडेंटेशन का उपयोग करें (चार स्पेस)
    function hello() {
        console.log("Hello, World!");
    }

हॉरिज़नटल रूल

तीन या अधिक हाइफन, एस्टरिस्क या अंडरस्कोर का उपयोग करें:

---
***
___

उन्नत सिंटेक्स

टेबल

| कॉलम 1 | कॉलम 2 | कॉलम 3 |
|-----|-----|-----|
| डेटा 1 | डेटा 2 | डेटा 3 |
| डेटा 4 | डेटा 5 | डेटा 6 |

अलाइनमेंट:
| बाएं एलाइन | केंद्र | दाएं एलाइन |
|:-------|:----:|-------:|
| बाएं | केंद्र | दाएं |

फुटनोट्स

यह फुटनोट का उदाहरण है[^1]।

[^1]: यह फुटनोट की विषयवस्तु है।

डेफिनिशन लिस्ट

शब्द 1
: परिभाषा 1

शब्द 2
: परिभाषा 2a
: परिभाषा 2b

संक्षिप्त रूप

HTML हाइपरटेक्स्ट मार्कअप भाषा है।

*[HTML]: Hyper Text Markup Language

GitHub स्टाइल Markdown (GFM)

सिंटेक्स हाइलाइटिंग

कोड ब्लॉक में भाषा निर्दिष्ट करें:

```python
def hello():
    print("Hello, World!")
```

```json
{
  "name": "example",
  "version": "1.1.0"
}
```

इमोजी

:smile: :heart: :thumbsup: :star:

यूज़र मेंशन और इश्यू रेफरेंस

@यूज़रनेम
#123 (इश्यू नंबर)
ऑर्गनाइजेशन/रिपॉजिटरी#123

HTML समर्थन

Markdown इनलाइन HTML का समर्थन करता है:

<div style="color: red;">
  यह लाल रंग का टेक्स्ट है
</div>

<details>
  <summary>विस्तार के लिए क्लिक करें</summary>
  छुपी हुई सामग्री
</details>

एस्केप करैक्टर

विशेष करैक्टर्स को एस्केप करने के लिए बैकस्लैश का उपयोग करें:

\* इटैलिक नहीं है
\# शीर्षक नहीं है
\[लिंक नहीं है\]

एस्केप किए जाने वाले करैक्टर:

\ ` * _ {} [] () # + - . ! |

सर्वोत्तम प्रथाएं

1. निरंतरता बनाए रखें

• एक शीर्षक शैली चुनें और उसका उपयोग करते रहें
• सूची चिह्न के रूप में * या - का एकरूप उपयोग करें
• इंडेंटेशन को निरंतर रखें (आमतौर पर 2 या 4 स्पेस का उपयोग करें)

2. पठनीयता को प्राथमिकता दें

• शीर्षकों के आगे-पीछे खाली लाइन जोड़ें
• पैराग्राफों के बीच खाली लाइन का उपयोग करें
• बहुत लंबी लाइनों से बचें (80-100 करैक्टर की सिफारिश)

3. सिमेंटिक उपयोग

• शीर्षकों का स्तरवार उपयोग करें, स्तर न छोड़ें
• उपयुक्त मार्कअप का उपयोग करें (जैसे सूची, उद्धरण आदि)
• लिंक और इमेज के लिए वर्णनात्मक टेक्स्ट प्रदान करें

सामान्य गलतियां

1. सूची फॉर्मेट की गलती

गलत:
-आइटम एक (स्पेस नहीं है)
- आइटम दो

सही:
- आइटम एक
- आइटम दो

2. लिंक फॉर्मेट की गलती

गलत:
(लिंक टेक्स्ट)[URL]

सही:
[लिंक टेक्स्ट](URL)

3. कोड ब्लॉक इंडेंटेशन

गलत:
```
कोड
```

सही:
```
कोड
```

टूल टिप्स

MD-PDF-WORD का उपयोग

MD-PDF-WORD इन सभी Markdown सिंटेक्स का पूर्ण समर्थन करता है और PDF और Word फॉर्मेट में सटीक रूपांतरण कर सकता है:

• सभी फॉर्मेट को संरक्षित करता है
• टेबल को सही तरीके से रेंडर करता है
• कोड हाइलाइटिंग का समर्थन करता है
• हिंदी टाइपसेटिंग को संभालता है

शॉर्टकट कीज़ (सामान्य एडिटर्स)

सुविधा	Windows/Linux	Mac
बोल्ड	Ctrl + B	Cmd + B
इटैलिक	Ctrl + I	Cmd + I
लिंक	Ctrl + K	Cmd + K
कोड	Ctrl + `	Cmd + `

सीखने के संसाधन

• आधिकारिक निर्देश: Markdown आधिकारिक दस्तावेज़
• GitHub गाइड: GitHub Markdown गाइड
• इंटरैक्टिव ट्यूटोरियल: Markdown Tutorial
• ऑनलाइन प्रीव्यू: MD-PDF-WORD के रीयल-टाइम प्रीव्यू फीचर का उपयोग करें

निष्कर्ष

Markdown सिंटेक्स में महारत हासिल करना आपको अधिक कुशलता से फॉर्मेटेड दस्तावेज़ बनाने में मदद करता है। बुनियादी टेक्स्ट फॉर्मेटिंग से लेकर उन्नत टेबल और कोड ब्लॉक तक, Markdown समृद्ध और संक्षिप्त सिंटेक्स प्रदान करता है। MD-PDF-WORD जैसे टूल्स के साथ, आप आसानी से Markdown दस्तावेज़ों को व्यावसायिक PDF या Word फॉर्मेट में परिवर्तित कर सकते हैं और विभिन्न दस्तावेज़ आवश्यकताओं को पूरा कर सकते हैं।

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