शीर्षक (core)
लाइन की शुरुआत एक से छह # चिह्नों से करो, फिर एक स्पेस दो। जितने ज़्यादा # चिह्न, उतना छोटा शीर्षक।
# Title
## Section
### Subsection
स्पेस मायने रखता है। सात # चिह्न शीर्षक नहीं होते।
अनुच्छेद और लाइन ब्रेक (core)
एक खाली लाइन नया अनुच्छेद शुरू करती है। अनुच्छेद के भीतर एक अकेली नई लाइन लाइन नहीं तोड़ती। टेक्स्ट आगे बहता रहता है।
नए अनुच्छेद के बिना लाइन ब्रेक के लिए, लाइन को दो स्पेस या एक बैकस्लैश से खत्म करो:
First line\
Second line
बोल्ड, इटैलिक और स्ट्राइकथ्रू
*italic* or _italic_
**bold** or __bold__
***bold and italic***
~~strikethrough~~
इटैलिक और बोल्ड core हैं। स्ट्राइकथ्रू GFM है। अगर चिह्न किसी शब्द के भीतर हो तो तारे का इस्तेमाल करो, क्योंकि _ शब्द के भीतर काम नहीं करता।
सूचियां
- Apples
- Bananas
- Green ones
- Yellow ones
1. Wake up
2. Make tea
3. Read
- [ ] Write the draft
- [x] Send the draft
बुलेट -, + या * से शुरू हो सकते हैं। क्रमांकित सूचियां एक संख्या और . या ) का उपयोग करती हैं। पहली संख्या तय करती है कि सूची कहां से शुरू होगी।
सूची के भीतर सूची बनाने के लिए, भीतर वाली सूची को ऐसे इंडेंट करो कि वह ऊपर वाले आइटम के टेक्स्ट के साथ सीध में आए। - Bananas के लिए यह दो स्पेस है।
बुलेट और संख्याएं core हैं। टास्क सूचियां, यानी [ ] और [x] वाले बॉक्स, GFM हैं।
लिंक
[PilcrowMD](https://pilcrowmd.com "Optional title")
<https://pilcrowmd.com>
https://pilcrowmd.com
पहला इनलाइन लिंक है: टेक्स्ट वर्गाकार कोष्ठक में, पता गोल कोष्ठक में। दूसरा कोणीय कोष्ठक में ऑटोलिंक है। दोनों core हैं।
तीसरा बिना किसी चिह्न का सीधा पता है। CommonMark इसे लिंक नहीं बनाता। GFM बनाता है, उन पतों के लिए जो http://, https:// या www. से शुरू होते हैं।
शीर्षक का लिंक
उसी फ़ाइल के किसी शीर्षक पर जाने के लिए, उसके एंकर से लिंक करो:
## My first section
[Go to the section](#my-first-section)
लिंक एक सामान्य इनलाइन लिंक है। GitHub पर एंकर शीर्षक के टेक्स्ट से बनता है: छोटे अक्षर, स्पेस की जगह हाइफ़न, और बाकी विराम-चिह्न हटा दिए जाते हैं। उसी टेक्स्ट वाले दूसरे शीर्षक में -1 जुड़ जाता है। दूसरे ऐप एंकर इसी तरह बना सकते हैं, लेकिन यह GitHub का नियम है, इसलिए जांच लो।
तस्वीरें
लिंक की तरह, आगे ! के साथ:

वर्गाकार कोष्ठक का टेक्स्ट विवरण (alt टेक्स्ट) है। तस्वीर का सिंटैक्स core है।
उद्धरण (core)
हर लाइन की शुरुआत > से करो:
> The best way to learn is to try.
कोड
वाक्य के भीतर कोड के छोटे टुकड़े के लिए, एकल बैकटिक का उपयोग करो:
Run `npm test` before you commit.
कोड के भीतर बैकटिक दिखाने के लिए, कोड को दोहरे बैकटिक में लपेटो।
ब्लॉक के लिए, तीन बैकटिक की फ़ेंस का उपयोग करो। खुलने वाली फ़ेंस के बाद भाषा का नाम लिखो:
```python
print("Hello")
```
फ़ेंस तीन टिल्ड ~~~ से भी बनाई जा सकती हैं। भाषा का नाम वैकल्पिक है। ऐप इसका उपयोग कोड को रंगने के लिए करते हैं। यह सब core है।
क्षैतिज रेखा (core)
एक लाइन पर अकेले तीन या ज़्यादा -, * या _:
---
--- के ऊपर एक खाली लाइन छोड़ो। टेक्स्ट की लाइन के ठीक नीचे यह उस टेक्स्ट को शीर्षक बना देता है।
तालिकाएं (GFM)
तालिका के लिए एक हेडर पंक्ति, एक डैश पंक्ति और डेटा पंक्तियां चाहिए:
| Fruit | Price |
|--------|-------|
| Apple | 1.20 |
तालिकाओं के और नियम हैं, जैसे सीध और पाइप को एस्केप करना। देखो Markdown तालिकाएं: उन्हें कैसे लिखें और पढ़ें।
एस्केपिंग: चिह्न को टेक्स्ट के रूप में दिखाना (core)
किसी चिह्न को सादे टेक्स्ट के रूप में दिखाने के लिए उसके पहले बैकस्लैश लगाओ:
\*not italic\*
किसी भी विराम-चिह्न को इस तरह एस्केप किया जा सकता है। कोड के भीतर बैकस्लैश काम नहीं करते।
फ़ुटनोट (GitHub feature)
This claim needs a source.[^1]
[^1]: Here is the source.
फ़ुटनोट CommonMark या GFM स्पेसिफ़िकेशन में नहीं हैं। GitHub उन्हें समर्थन देता है। नोट का टेक्स्ट पेज के नीचे दिखता है, चाहे तुम उसे फ़ाइल में कहीं भी लिखो। GitHub विकी में फ़ुटनोट को समर्थन नहीं देता।
कॉलआउट (GitHub feature)
कॉलआउट एक उद्धरण है, जिसकी पहली लाइन में एक लेबल होता है:
> [!NOTE]
> Useful information the reader should know.
इसके प्रकार NOTE, TIP, IMPORTANT, WARNING और CAUTION हैं। ये किसी भी स्पेसिफ़िकेशन में नहीं हैं। इनका कम इस्तेमाल करो।
Markdown पढ़ना
सादे टेक्स्ट एडिटर में ये सारे चिह्न दिखते रहते हैं। Markdown रीडर उन्हें साफ़ पन्ने में बदल देता है।
PilcrowMD Android और Mac पर तालिकाएं, फ़ुटनोट, GitHub-शैली के कॉलआउट और शीर्षक पर ले जाने वाले लिंक दिखाता है। Mac पर यह टास्क सूचियां भी दिखाता है।
आम सवाल
मुझे पहले कौन सा Markdown सीखना चाहिए? Core चिह्न: शीर्षक, बोल्ड, इटैलिक, सूचियां, लिंक, कोड और उद्धरण। ये हर Markdown ऐप में काम करते हैं। फिर तालिकाएं और टास्क सूचियां जोड़ो, क्योंकि ज़्यादातर ऐप GFM को समर्थन देते हैं।
मेरा Markdown दूसरे ऐप में अलग क्यों दिखता है? ऐप अलग-अलग नियमों का पालन करते हैं। CommonMark बुनियाद है, GFM उसमें कुछ जोड़ता है, और कुछ सुविधाएं, जैसे फ़ुटनोट और कॉलआउट, किसी में भी नहीं हैं। अगर कोई चिह्न काम नहीं करता, तो संभवतः ऐप उसे समर्थन नहीं देता।
क्या # और - के बाद स्पेस देना ज़रूरी है? हां। # Title और - Item लिखो। स्पेस के बिना लाइन सादा टेक्स्ट ही रहती है।
Mac पर भी: Mac के लिए PilcrowMD (बीटा)