लेख निर्देशिका
Markdownमतलब क्या है?
मार्कडाउन सिंटैक्स/स्वरूपण मार्कअप का उपयोग कैसे करें?
अवलोकन
मार्कडाउन जॉन ग्रुबर द्वारा बनाई गई एक हल्की मार्कअप भाषा है।
यह लोगों को "सादे पाठ प्रारूप में दस्तावेज़ लिखने की अनुमति देता है जो पढ़ने और लिखने में आसान है, और फिर उन्हें वैध एक्सएचटीएमएल (या एचटीएमएल) दस्तावेज़ों में परिवर्तित करता है"।
भाषा में पहले से ही ई-मेल में पाए जाने वाले सादा पाठ मार्कअप की कई विशेषताएं शामिल हैं।
जॉन ग्रुबर ने 2004 में आरोन स्वार्ट्ज के सहयोग से सिंटैक्स पर बड़े हिस्से में मार्कडाउन भाषा बनाई।भाषा का उद्देश्य "एक सादा पाठ प्रारूप का उपयोग करना है जो पढ़ने में आसान है, लिखने में आसान है, और वैकल्पिक रूप से वैध एक्सएचटीएमएल (या एचटीएमएल) में परिवर्तित होता है"।
उद्देश्य
मार्कडाउन का लक्ष्य "पढ़ने में आसान और लिखने में आसान" होना है।
पठनीयता, वैसे भी करो网络 营销, उपयोगकर्ता अनुभव बहुत महत्वपूर्ण है।
मार्कडाउन में लिखा गया एक दस्तावेज़ सीधे सादे पाठ में प्रकाशित होने में सक्षम होना चाहिए, और कई टैग या स्वरूपण निर्देशों से बना नहीं होना चाहिए।
मार्कडाउन सिंटैक्स कुछ मौजूदा टेक्स्ट-टू-एचटीएमएल प्रारूपों से प्रभावित होता है, जिसमें सेटेक्स्ट, एटीएक्स, टेक्सटाइल, रीस्ट्रक्चर्ड टेक्स्ट, ग्रुटाटेक्स्ट और एटटेक्स्ट शामिल हैं, लेकिन प्रेरणा का सबसे बड़ा स्रोत सादा पाठ ईमेल प्रारूप है।
संक्षेप में, मार्कडाउन का सिंटैक्स सभी प्रतीकों से बना है, जिन्हें सावधानी से चुना गया है और उनके कार्य एक नज़र में स्पष्ट हैं।उदाहरण के लिए: टेक्स्ट को *जोर* जैसा दिखाने के लिए उसके चारों ओर तारक लगाएं।
मार्कडाउन में सूचियाँ ऐसी दिखती हैं, ठीक है, सूचियाँ। मार्कडाउन में ब्लॉकक्वॉट्स वास्तव में टेक्स्ट के एक टुकड़े को उद्धृत करने जैसा दिखता है, जैसा आपने ईमेल में देखा है।
एचटीएमएल के साथ संगत
मार्कडाउन व्याकरण का लक्ष्य वेब के लिए एक लेखन भाषा होना है।
मार्कडाउन का मतलब HTML को बदलना नहीं है, या इसके करीब भी आना है, इसमें बहुत कम प्रकार के सिंटैक्स हैं और HTML मार्कअप के केवल एक छोटे से सबसेट से मेल खाते हैं। HTML दस्तावेज़ों को लिखना आसान बनाने के लिए मार्कडाउन की कल्पना नहीं की गई थी।
मेरी राय में, HTML लिखना पहले से ही आसान है। मार्कडाउन का विचार दस्तावेजों को पढ़ने, लिखने और इच्छानुसार बदलने में आसान बनाना है। एचटीएमएल एक प्रकाशन प्रारूप है, मार्कडाउन एक हैcopywritingलिखित प्रारूप।जैसे, मार्कडाउन का फ़ॉर्मेटिंग सिंटैक्स केवल वही शामिल करता है जो सादा पाठ कर सकता है।
टैग जो मार्कडाउन द्वारा कवर नहीं किए गए हैं उन्हें सीधे दस्तावेज़ में HTML में लिखा जा सकता हैवेब प्रचारनकल।इसे HTML या मार्कडाउन के रूप में चिह्नित करने की कोई आवश्यकता नहीं है; बस सीधे मार्कअप जोड़ें।
विवश होने के लिए केवल कुछ HTML ब्लॉक तत्व - जैसे <div>,<table>,<pre>,<p> और अन्य टैग, उन्हें पहले और बाद में रिक्त पंक्तियों वाले अन्य सामग्री क्षेत्रों से अलग किया जाना चाहिए, और उनके उद्घाटन और समापन टैग टैब या रिक्त स्थान के साथ इंडेंट नहीं होने चाहिए। मार्कडाउन जनरेटर इतना स्मार्ट है कि अनावश्यक HTML ब्लॉक टैग नहीं जोड़ सकता <p> लेबल।
उदाहरण इस प्रकार है, मार्कडाउन फ़ाइल में एक HTML तालिका जोड़ना:
这是一个普通段落。
<table>
<tr>
<td>Foo</td>
</tr>
</table>
这是另一个普通段落。
ध्यान दें कि HTML ब्लॉक टैग के बीच मार्कडाउन स्वरूपण सिंटैक्स संसाधित नहीं किया जाएगा।उदाहरण के लिए, यदि आप किसी HTML ब्लॉक के अंदर मार्कडाउन शैली का उपयोग करते हैं*强调*कोई प्रभाव नहीं पड़ेगा।
HTML अनुभाग (इनलाइन) टैग जैसे <span>,<cite>,<del> मार्कडाउन पैराग्राफ, सूचियों या शीर्षकों में स्वतंत्र रूप से उपयोग किया जा सकता है।व्यक्तिगत आदतों के अनुसार, आप मार्कडाउन प्रारूप का उपयोग किए बिना HTML टैग्स को प्रारूपित करने के लिए भी उपयोग कर सकते हैं।उदाहरण: यदि आप HTML पसंद करते हैं <a> 或 <img> टैग, जिनका उपयोग मार्कडाउन द्वारा प्रदान किए गए लिंक या छवि टैग सिंटैक्स के बिना सीधे किया जा सकता है।
HTML ब्लॉक टैग के विपरीत, मार्कडाउन सिंटैक्स HTML अनुभाग टैग के बीच मान्य है।
विशेष वर्णों का स्वचालित रूपांतरण
HTML फ़ाइलों में, दो वर्ण होते हैं जिन्हें विशेष हैंडलिंग की आवश्यकता होती है: < 和 & . < प्रारंभ टैग के लिए प्रतीकों का उपयोग किया जाता है,& HTML निकायों को चिह्नित करने के लिए प्रतीकों का उपयोग किया जाता है, यदि आप इन वर्णों के प्रोटोटाइप को प्रदर्शित करना चाहते हैं, तो आपको इकाई प्रपत्र का उपयोग करना होगा, जैसे < 和 &.
& यदि आप टाइप करने जा रहे हैं, तो वर्ण विशेष रूप से वेब दस्तावेज़ लेखकों के लिए पीड़ादायक हैं "AT&T", आपको लिखना होगा"AT&T".यूआरएल में रहते हुए & वर्ण भी परिवर्तित हो जाते हैं।उदाहरण के लिए आप इससे लिंक करना चाहते हैं:
http://images.google.com/images?num=30&q=larry+bird
आपको URL रूपांतरण इस प्रकार लिखना होगा:
http://images.google.com/images?num=30&q=larry+bird
लिंक टैग में रखा जाना है href गुणों में।कहने की जरूरत नहीं है, इसे अनदेखा करना आसान है, और संभवतः HTML मानकों के सत्यापन द्वारा पाई गई त्रुटियों की सबसे बड़ी संख्या है।
मार्कडाउन आपको पात्रों को स्वाभाविक रूप से लिखने की अनुमति देता है, और यह ध्यान रखता है कि क्या परिवर्तित करने की आवश्यकता है।यदि तुम प्रयोग करते हो & एक वर्ण एक HTML वर्ण इकाई का हिस्सा है, इसे वैसे ही छोड़ दिया जाता है, अन्यथा इसे बदल दिया जाता है &;.
इसलिए यदि आप दस्तावेज़ में कॉपीराइट प्रतीक सम्मिलित करना चाहते हैं ©, तुम लिख सकते हो:
©
मार्कडाउन इसे अछूता छोड़ देगा।और अगर आप लिखते हैं:
AT&T
मार्कडाउन इसे इसमें बदल देगा:
AT&T
ऐसी ही स्थिति में भी होती है < अंकन, चूंकि मार्कडाउन HTML संगतता की अनुमति देता है, यदि आप डालते हैं < HTML टैग के लिए प्रतीकों का उपयोग सीमांकक के रूप में किया जाता है, और मार्कडाउन उन पर कोई रूपांतरण नहीं करेगा, लेकिन यदि आप लिखते हैं:
4 < 5
मार्कडाउन इसे इसमें बदल देगा:
4 < 5
हालाँकि, यह ध्यान दिया जाना चाहिए कि कोड के दायरे में, चाहे वह इनलाइन हो या ब्लॉक, < 和 & दोनों प्रतीकअवश्यHTML इकाइयों में परिवर्तित हो जाते हैं, एक ऐसी सुविधा जो आपको मार्कडाउन में आसानी से HTML कोड लिखने की अनुमति देती है (HTML के विपरीत, जहां आप सभी < 和 & HTML फ़ाइल में HTML कोड लिखने के लिए सभी को HTML इकाइयों में बदल दिया जाता है। )
ब्लॉक तत्व
पैराग्राफ और लाइन ब्रेक
एक मार्कडाउन पैराग्राफ टेक्स्ट की एक या एक से अधिक लगातार पंक्तियों से बना होता है, पहले और बाद में एक से अधिक रिक्त रेखा (रिक्त रेखा की परिभाषा यह है कि यह प्रदर्शित होने पर खाली प्रतीत होती है और इसे एक रिक्त रेखा माना जाता है। के लिए) उदाहरण के लिए, यदि किसी पंक्ति में केवल रिक्त स्थान और टैब हैं, तो रेखा को भी एक रिक्त रेखा के रूप में माना जाएगा)।सामान्य पैराग्राफ को रिक्त स्थान या टैब के साथ इंडेंट नहीं किया जाना चाहिए।
वाक्यांश "पाठ की एक या अधिक लगातार पंक्तियों से मिलकर बनता है" वास्तव में इसका अर्थ है कि मार्कडाउन पैराग्राफ के भीतर मजबूर न्यूलाइन (न्यूलाइन्स का सम्मिलन) की अनुमति देता है, एक ऐसी सुविधा जो अधिकांश अन्य टेक्स्ट-टू-एचटीएमएल प्रारूपों से अलग है (चलने योग्य प्रकार "कन्वर्ट लाइन ब्रेक सहित) "विकल्प), अन्य प्रारूप प्रत्येक पंक्ति विराम को . में बदल देंगे <br /> लेबल।
如果 你वास्तव मेंसम्मिलित करने के लिए मार्कडाउन पर भरोसा करना चाहते हैं <br /> लेबल के लिए, सम्मिलन स्थान पर दो या अधिक रिक्त स्थान दबाएं और फिर एंटर दबाएं।
वास्तव में, इसे उत्पन्न करने में थोड़ा अधिक काम (अतिरिक्त स्थान) लगता है <br /> , लेकिन बस "प्रत्येक नई पंक्ति को परिवर्तित किया जाता है <br />"मार्कडाउन में विधि उपयुक्त नहीं है, मार्कडाउन मेंaiएल-शैली ब्लॉककोट्स और मल्टी-पैराग्राफ सूचियां न केवल अधिक उपयोगी हैं बल्कि लाइन ब्रेक के साथ टाइपसेटिंग करते समय पढ़ने में भी आसान होती हैं।
शीर्षक
मार्कडाउन हेडिंग के लिए दो सिंटैक्स का समर्थन करता है, सेटेक्स्ट-लाइक और एटीएक्स-लाइक।
सेटटेक्स्ट जैसा फॉर्म नीचे की रेखा के साथ फॉर्म है, का उपयोग कर = (उच्चतम शीर्षक) और - (द्वितीय क्रम शीर्षक), उदाहरण के लिए:
This is an H1
=============
This is an H2
-------------
कोई भी राशि = 和 - प्रभावी हो सकता है।
एटीएक्स जैसा फॉर्म लाइन की शुरुआत में 1 से 6 को प्रविष्ट करता है # , शीर्षक 1 से 6 के अनुरूप, उदाहरण के लिए:
# 这是 H1
## 这是 H2
###### 这是 H6
आप वैकल्पिक रूप से एटीएक्स-जैसे हेडर को "बंद" कर सकते हैं, यह विशुद्ध रूप से सौंदर्यशास्त्र के लिए है, यदि आप इस तरह से सहज महसूस करते हैं, तो आप इसे लाइन के अंत में जोड़ सकते हैं #, जबकि रेखा समाप्त होती है # संख्या को शुरुआत के समान नहीं होना चाहिए (पंक्ति की शुरुआत में पाउंड वर्णों की संख्या शीर्षक के क्रम को निर्धारित करती है):
# 这是 H1 #
## 这是 H2 ##
### 这是 H3 ######
Blockquotes Blockquotes
मार्कडाउन मार्कअप ब्लॉकक्वाट्स का उपयोग ईमेल में उपयोग किए जाने के समान ही किया जाता है > उद्धरणों का।यदि आप ईमेल पत्रों में उद्धरणों से परिचित हैं, तो आप जानते हैं कि मार्कडाउन फ़ाइल में एक ब्लॉक कोट कैसे बनाया जाता है, जो ऐसा लगेगा कि आप स्वयं लाइनों को तोड़ते हैं, फिर जोड़ें > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
>
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.
मार्कडाउन आपको आलसी होने और पूरे पैराग्राफ की केवल पहली पंक्ति जोड़ने की अनुमति देता है > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
ब्लॉक संदर्भों को नेस्ट किया जा सकता है (उदाहरण: संदर्भों के भीतर संदर्भ) की एक अलग संख्या जोड़कर > :
> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.
अन्य मार्कडाउन सिंटैक्स का उपयोग उद्धृत ब्लॉकों में भी किया जा सकता है, जिसमें शीर्षक, सूचियाँ, कोड ब्लॉक आदि शामिल हैं:
> ## 这是一个标题。
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
> 给出一些例子代码：
>
> return shell_exec("echo $input | $markdown_script");
कोई भी अच्छा टेक्स्ट एडिटर आसानी से ईमेल-शैली के उद्धरण बना सकता है।उदाहरण के लिए BBEdit में आप टेक्स्ट का चयन कर सकते हैं और फिर मेनू से चुन सकते हैंउद्धरण पदानुक्रम बढ़ाएँ.
सूची
मार्कडाउन क्रमित और अव्यवस्थित दोनों सूचियों का समर्थन करता है।
अव्यवस्थित सूचियाँ सूची चिह्नक के रूप में तारक, धन चिह्न, या ऋण चिह्नों का उपयोग करती हैं:
* Red
* Green
* Blue
के बराबर:
+ Red
+ Green
+ Blue
इसके बराबर:
- Red
- Green
- Blue
आदेशित सूचियाँ एक अवधि के बाद संख्याओं का उपयोग करती हैं:
1. Bird
2. McHale
3. Parish
यह ध्यान रखना महत्वपूर्ण है कि सूची टैग पर आपके द्वारा उपयोग की जाने वाली संख्या आउटपुट HTML को प्रभावित नहीं करती है। उपरोक्त सूची के लिए परिणामी HTML मार्कअप होगा:
<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>
यदि आपकी सूची मार्कअप इस प्रकार लिखा गया है:
1. Bird
1. McHale
1. Parish
या और भी:
3. Bird
1. McHale
8. Parish
आप दोनों को बिल्कुल वही HTML आउटपुट मिलेगा।मुद्दा यह है कि, आप मार्कडाउन फ़ाइल में सूची संख्याओं को आउटपुट परिणामों के समान बना सकते हैं, या यदि आप आलसी हैं, तो आपको संख्याओं की शुद्धता की बिल्कुल भी परवाह करने की आवश्यकता नहीं है।
यदि आप आलसी लेखन का उपयोग करते हैं, तो पहले आइटम के लिए 1 से प्रारंभ करने की अनुशंसा की जाती है, क्योंकि मार्कडाउन भविष्य में आदेशित सूचियों की प्रारंभ विशेषता का समर्थन कर सकता है।
सूची आइटम टैग आमतौर पर सबसे बाईं ओर रखा जाता है, लेकिन इसे 3 रिक्त स्थान तक इंडेंट किया जा सकता है, और आइटम टैग के बाद कम से कम एक स्थान या टैब होना चाहिए।
सूची को बेहतर बनाने के लिए, आप सामग्री को एक निश्चित इंडेंट के साथ व्यवस्थित कर सकते हैं:
* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
लेकिन अगर आप आलसी हैं, तो यह भी ठीक है:
* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
यदि सूची आइटम को रिक्त पंक्तियों से अलग किया जाता है, तो मार्कडाउन HTML को आउटपुट करते समय आइटम सामग्री का उपयोग करेगा। <p> लेबल लपेटे जाते हैं, उदाहरण के लिए:
* Bird
* Magic
में परिवर्तित किया जाएगा:
<ul>
<li>Bird</li>
<li>Magic</li>
</ul>
लेकिन यह:
* Bird
* Magic
में परिवर्तित किया जाएगा:
<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>
सूची आइटम में कई पैराग्राफ हो सकते हैं, और प्रत्येक आइटम के तहत पैराग्राफ को 4 रिक्त स्थान या 1 टैब द्वारा इंडेंट किया जाना चाहिए:
1. This is a list item with two paragraphs. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit. Aliquam hendrerit
mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet
vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
sit amet velit.
2. Suspendisse id sem consectetuer libero luctus adipiscing.
यदि आप प्रत्येक पंक्ति को इंडेंट करते हैं तो यह बहुत बेहतर दिखता है, निश्चित रूप से, यदि आप आलसी हैं, तो मार्कडाउन भी अनुमति देता है:
* This is a list item with two paragraphs.
This is the second paragraph in the list item. You're
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.
* Another item in the same list.
यदि आप किसी सूची आइटम के अंदर एक संदर्भ रखना चाहते हैं, तो > इसे इंडेंट करने की आवश्यकता है:
* A list item with a blockquote:
> This is a blockquote
> inside a list item.
यदि आप एक कोड ब्लॉक रखना चाहते हैं, तो ब्लॉक को इंडेंट करना होगादो बार, जो 8 रिक्त स्थान या 2 टैब है:
* 一列表项包含一个列表区块：
<代码写在这>
बेशक, वस्तुओं की एक सूची गलती से उत्पन्न हो सकती है, कुछ इस तरह:
1986. What a great season.
दूसरे शब्दों में, यह पंक्ति की शुरुआत में दिखाई देता हैसंख्या-अवधि-रिक्त, इससे बचने के लिए, आप अवधि से पहले बैकस्लैश जोड़ सकते हैं।
1986\. What a great season.
कोड ब्लॉक
प्रोग्राम से संबंधित लेखन या टैग भाषा स्रोत कोड में आमतौर पर पहले से ही टाइपसेट कोड ब्लॉक होते हैं। आमतौर पर, हम नहीं चाहते कि ये ब्लॉक सामान्य पैराग्राफ फाइलों के रूप में टाइपसेट हों, लेकिन उन्हें वैसे ही प्रदर्शित करें जैसे वे हैं। मार्कडाउन का उपयोग करेगा <pre> 和 <code> कोड ब्लॉक को लपेटने के लिए टैग।
मार्कडाउन में कोड ब्लॉक बनाना 4 रिक्त स्थान या 1 टैब को इंडेंट करने जितना आसान है। उदाहरण के लिए, निम्नलिखित दर्ज करें:
这是一个普通段落：
这是一个代码区块。
मार्कडाउन में बदल जाएगा:
<p>这是一个普通段落：</p>
<pre><code>这是一个代码区块。
</code></pre>
यह प्रथम-क्रम इंडेंटेशन प्रति पंक्ति (4 रिक्त स्थान या 1 टैब) हटा दिया जाता है, उदाहरण के लिए:
Here is an example of AppleScript:
tell application "Foo"
beep
end tell
में परिवर्तित किया जाएगा:
<p>Here is an example of AppleScript:</p>
<pre><code>tell application "Foo"
beep
end tell
</code></pre>
कोड का एक ब्लॉक अनइंडेंटेड लाइन (या फ़ाइल के अंत) तक जारी रहता है।
कोड ब्लॉक के अंदर, & , < 和 > यह स्वचालित रूप से HTML संस्थाओं में परिवर्तित हो जाएगा। यह विधि उदाहरण के लिए HTML स्रोत कोड डालने के लिए मार्कडाउन का उपयोग करना आपके लिए बहुत आसान बनाती है, बस इसे कॉपी और पेस्ट करें, इंडेंटेशन जोड़ें, और बाकी मार्कडाउन इसे आपके लिए संभाल लेगा, के लिए उदाहरण:
<div class="footer">
© 2004 Foo Corporation
</div>
में परिवर्तित किया जाएगा:
<pre><code><div class="footer">
© 2004 Foo Corporation
</div>
</code></pre>
कोड ब्लॉक में, सामान्य मार्कडाउन सिंटैक्स को परिवर्तित नहीं किया जाएगा, जैसे कि तारांकन केवल तारक हैं, जिसका अर्थ है कि आप मार्कडाउन सिंटैक्स से संबंधित फ़ाइलों को आसानी से मार्कडाउन सिंटैक्स में लिख सकते हैं।
विभाजन रेखा
आप विभाजक बनाने के लिए एक रेखा पर तीन से अधिक तारांकन, ऋण चिह्न, अंडरस्कोर का उपयोग कर सकते हैं, रेखा में और कुछ नहीं।आप तारांकन या ऋण चिह्नों के बीच रिक्त स्थान भी डाल सकते हैं।निम्नलिखित में से प्रत्येक नोटेशन एक विभाजक बना सकता है:
* * *
***
*****
- - -
---------------------------------------
खंड तत्व
लिंक
मार्कडाउन लिंक सिंटैक्स के दो रूपों का समर्थन करता है: इन - लाइन和संदर्भदो रूप।
किसी भी तरह से, लिंक टेक्स्ट को [वर्ग कोष्ठक] से चिह्नित किया जाता है।
बनाने के लिएइन - लाइनयदि आप लिंक का शीर्षक टेक्स्ट जोड़ना चाहते हैं, तो शीर्षक टेक्स्ट को URL के बाद दोहरे उद्धरण चिह्नों के साथ लपेटें, उदाहरण के लिए:
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
उत्पादन करेंगे:
<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>
<p><a href="http://example.net/">This link</a> has no
title attribute.</p>
यदि आप एक ही होस्ट पर संसाधनों से लिंक कर रहे हैं, तो आप सापेक्ष पथों का उपयोग कर सकते हैं:
See my [About](/about/) page for details.
संदर्भलिंक टेक्स्ट के ब्रैकेट के बाद लिंक के बाद एक और स्क्वायर ब्रैकेट होता है, और लिंक को पहचानने के लिए इस्तेमाल किया जाने वाला चिह्न दूसरे स्क्वायर ब्रैकेट में भरा जाना चाहिए:
This is [an example][id] reference-style link.
आप वैकल्पिक रूप से दो वर्गाकार कोष्ठकों के बीच एक स्थान भी रख सकते हैं:
This is [an example] [id] reference-style link.
फिर, फ़ाइल में कहीं भी, आप इस टैग की लिंक सामग्री को परिभाषित कर सकते हैं:
[id]: http://example.com/ "Optional Title Here"
लिंक सामग्री को फॉर्म में परिभाषित किया गया है:
- स्क्वायर ब्रैकेट (वैकल्पिक रूप से इंडेंटेशन के लिए तीन रिक्त स्थान से पहले) जिसमें लिंक टेक्स्ट दर्ज किया गया है
- उसके बाद एक कोलन
- एक या अधिक रिक्त स्थान या टैब के बाद
- अगले लिंक का URL
- वैकल्पिक रूप से शीर्षक सामग्री का पालन करें, जिसे सिंगल कोट्स, डबल कोट्स या कोष्ठक में संलग्न किया जा सकता है
निम्नलिखित तीन लिंक की परिभाषाएँ समान हैं:
[foo]: http://example.com/ "Optional Title Here"
[foo]: http://example.com/ 'Optional Title Here'
[foo]: http://example.com/ (Optional Title Here)
सावधान:एक ज्ञात समस्या है जहाँ Markdown.pl 1.0.1 एकल उद्धरणों में संलग्न लिंक शीर्षकों की उपेक्षा करता है।
लिंक URL को कोण कोष्ठक में भी संलग्न किया जा सकता है:
[id]: <http://example.com/> "Optional Title Here"
आप शीर्षक विशेषता को अगली पंक्ति में भी रख सकते हैं, या कुछ इंडेंटेशन जोड़ सकते हैं, जो यूआरएल बहुत लंबा होने पर बेहतर दिखाई देगा:
[id]: http://example.com/longish/path/to/resource/here
"Optional Title Here"
URL परिभाषा का उपयोग केवल लिंक जनरेट करते समय किया जाता है, और सीधे फ़ाइल में प्रकट नहीं होता है।
लिंक पहचान टैग में अक्षर, संख्याएं, रिक्त स्थान और विराम चिह्न हो सकते हैं, लेकिन ऐसा नहीं हैनहींयह केस संवेदी है, इसलिए निम्नलिखित दो लिंक समान हैं:
[link text][a]
[link text][A]
निहित लिंक टैगसुविधा आपको एक लिंक टैग निर्दिष्ट करने की अनुमति देती है। इस मामले में, लिंक टैग को लिंक टेक्स्ट के समकक्ष माना जाएगा। एक अंतर्निहित लिंक टैग का उपयोग करने के लिए, लिंक टेक्स्ट के बाद बस एक खाली वर्ग ब्रैकेट जोड़ें। यदि आप "Google" चाहते हैं " google.com से लिंक करके, आप इसे सरल बना सकते हैं:
[Google][]
फिर लिंक सामग्री को परिभाषित करें:
[Google]: http://google.com/
चूंकि लिंक टेक्स्ट में व्हाइटस्पेस हो सकता है, इस सरलीकृत मार्कअप में कई शब्द हो सकते हैं:
Visit [Daring Fireball][] for more information.
फिर लिंक को परिभाषित करने के लिए आगे बढ़ें:
[Daring Fireball]: http://daringfireball.net/
लिंक की परिभाषा फ़ाइल में कहीं भी रखी जा सकती है। मैं इसे सीधे उस पैराग्राफ के बाद रखना पसंद करता हूं जहां लिंक दिखाई देता है। आप इसे एक टिप्पणी की तरह फ़ाइल के अंत में भी डाल सकते हैं।
संदर्भ लिंक का एक उदाहरण यहां दिया गया है:
I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].
[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"
यदि आप इसे लिखने के लिए लिंक नाम का उपयोग करने के लिए बदलते हैं:
I get 10 times more traffic from [Google][] than from
[Yahoo][] or [MSN][].
[google]: http://google.com/ "Google"
[yahoo]: http://search.yahoo.com/ "Yahoo Search"
[msn]: http://search.msn.com/ "MSN Search"
लिखने के उपरोक्त दो तरीके निम्नलिखित HTML उत्पन्न करेंगे।
<p>I get 10 times more traffic from <a href="http://google.com/"
title="Google">Google</a> than from
<a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a>
or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p>
नीचे उसी सामग्री की एक मार्कडाउन फ़ाइल है जो इनलाइन लिखी गई है, जो तुलना के लिए प्रदान की गई है:
I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").
वास्तव में, संदर्भ-शैली लिंक की बात यह नहीं है कि यह लिखना आसान है, बल्कि यह है कि इसे पढ़ना आसान है। उपरोक्त उदाहरण की तुलना करें। संदर्भ-शैली के लेख में केवल 81 वर्ण हैं, लेकिन इनलाइन फॉर्म में वृद्धि होगी 176 अक्षर। , अगर यह शुद्ध HTML प्रारूप में लिखा गया है, तो 234 वर्ण होंगे। HTML प्रारूप में, पाठ से अधिक टैग हैं।
मार्कडाउन के संदर्भ-शैली के लिंक का उपयोग करके, आप दस्तावेज़ को ब्राउज़र के अंतिम परिणाम की तरह बना सकते हैं, जिससे आप पैराग्राफ टेक्स्ट के बाहर कुछ मार्कअप-संबंधित मेटाडेटा को स्थानांतरित कर सकते हैं, और आप लेख को पढ़ने का अनुभव किए बिना लिंक जोड़ सकते हैं। .
强调
मार्कडाउन तारांकन का उपयोग करता है (*) और नीचे की रेखा (_) एक रेखांकित शब्द को चिह्नित करने के लिए एक प्रतीक के रूप में, is * 或 _ आसपास के शब्दों को में बदल दिया जाता है <em> लेबल से घिरा हुआ, दो के साथ * 或 _अगर इसे लपेटा जाता है, तो इसे में बदल दिया जाएगा <strong>,उदाहरण के लिए:
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
में बदल जाएगा:
<em>single asterisks</em>
<em>single underscores</em>
<strong>double asterisks</strong>
<strong>double underscores</strong>
आप जो भी शैली पसंद करते हैं उसका उपयोग कर सकते हैं, केवल सीमा यह है कि आप टैग को खोलने के लिए प्रतीक और इसे समाप्त करने के लिए प्रतीक का उपयोग कर सकते हैं।
सीधे टेक्स्ट के बीच में भी जोर डाला जा सकता है:
un*frigging*believable
परंतुयदि आपका * 和 _ यदि दोनों तरफ सफेद जगह है, तो उन्हें सामान्य प्रतीकों के रूप में माना जाता है.
टेक्स्ट के पहले और बाद में सामान्य तारांकन या अंडरस्कोर डालने के लिए, आप बैकस्लैश का उपयोग कर सकते हैं:
\*this text is surrounded by literal asterisks\*
कोड
यदि आप इनलाइन कोड के एक छोटे टुकड़े को चिह्नित करना चाहते हैं, तो आप इसे बैकटिक्स में लपेट सकते हैं (`), जैसे:
Use the `printf()` function.
उत्पादन करेंगे:
<p>Use the <code>printf()</code> function.</p>
यदि आप किसी कोड सेक्शन के अंदर बैकटिक्स डालना चाहते हैं, तो आप कई बैकटिक्स के साथ कोड सेक्शन को शुरू और समाप्त कर सकते हैं:
``There is a literal backtick (`) here.``
यह वाक्यविन्यास उत्पन्न करता है:
<p><code>There is a literal backtick (`) here.</code></p>
आप कोड अनुभाग के आरंभ और अंत में एक रिक्त स्थान रख सकते हैं, एक शुरुआत के बाद और दूसरा अंत से पहले, ताकि आप अनुभाग की शुरुआत में बैकटिक्स सम्मिलित कर सकें:
A single backtick in a code span: `` ` ``
A backtick-delimited string in a code span: `` `foo` ``
उत्पादन करेंगे:
<p>A single backtick in a code span: <code>`</code></p>
<p>A backtick-delimited string in a code span: <code>`foo`</code></p>
कोड अनुभाग के अंदर,& और कोण कोष्ठक都स्वचालित रूप से HTML संस्थाओं में परिवर्तित हो जाएगा, जिससे HTML स्रोत कोड सम्मिलित करना आसान हो जाता है, मार्कडाउन निम्नलिखित पैराग्राफ रखेगा:
Please don't use any `<blink>` tags.
प्रति:
<p>Please don't use any <code><blink></code> tags.</p>
आप इसे भी लिख सकते हैं:
`—` is the decimal-encoded equivalent of `—`.
उत्पन्न करना:
<p><code>—</code> is the decimal-encoded
equivalent of <code>—</code>.</p>
图片
जाहिर है, केवल-पाठ्य अनुप्रयोग में छवियों को सम्मिलित करने के लिए "प्राकृतिक" सिंटैक्स को डिज़ाइन करना मुश्किल है।
मार्कडाउन छवियों को चिह्नित करने के लिए लिंक के समान सिंटैक्स का उपयोग करता है, और दो शैलियों की भी अनुमति देता है: इन - लाइन和संदर्भ.
इनलाइन छवि सिंटैक्स इस तरह दिखता है:
विवरण निम्नानुसार हैं:
- विस्मयादिबोधक चिह्न
! - छवि के लिए वैकल्पिक पाठ के साथ वर्गाकार कोष्ठक का अनुसरण करें
- इसके बाद छवि के URL के साथ सामान्य कोष्ठक होते हैं, और अंत में उद्धरणों में संलग्न एक वैकल्पिक 'शीर्षक' पाठ होता है।
संदर्भ छवि सिंटैक्स इस तरह दिखता है:
![Alt text][id]
"आईडी" छवि संदर्भ का नाम है, जिसे लिंक संदर्भ के समान ही परिभाषित किया गया है:
[id]: url/to/image "Optional title attribute"
अब तक, मार्कडाउन के पास छवि की चौड़ाई और ऊंचाई निर्दिष्ट करने का कोई तरीका नहीं है, यदि आवश्यक हो, तो आप सामान्य का उपयोग कर सकते हैं <img> लेबल।
其它
ऑटो लिंक
मार्कडाउन अपेक्षाकृत छोटे स्वचालित लिंक के रूप में URL और ईमेल मेलबॉक्स को संसाधित करने का समर्थन करता है। जब तक वे कोण कोष्ठक में संलग्न हैं, मार्कडाउन स्वचालित रूप से इसे एक लिंक में बदल देगा।सामान्य URL का लिंक टेक्स्ट लिंक पते के समान होता है, उदाहरण के लिए:
<http://example.com/>
मार्कडाउन को इसमें बदल दिया जाएगा:
<a href="http://example.com/">http://example.com/</a>
ईमेल पतों की स्वचालित लिंकिंग भी समान है, सिवाय इसके कि मार्कडाउन पहले एक एन्कोडिंग रूपांतरण प्रक्रिया करेगा, टेक्स्ट वर्णों को हेक्साडेसिमल HTML इकाइयों में परिवर्तित करेगा। यह प्रारूप कुछ खराब ईमेल पता संग्रह रोबोटों को बेवकूफ बना सकता है, जैसे:
<[email protected]>
मार्कडाउन में बदल जाएगा:
<a href="mailto:addre
[email protected]
m">address@exa
mple.com</a>
ब्राउज़र में, यह स्ट्रिंग (वास्तव में <a href="mailto:[email protected]">[email protected]</a>) क्लिक करने योग्य "[email protected]" लिंक बन जाता है।
(हालांकि यह दृष्टिकोण बहुत सारे रोबोटों को बेवकूफ बना सकता है, यह उन सभी को रोक नहीं सकता है, लेकिन यह कुछ भी नहीं से बेहतर है। किसी भी स्थिति में, आपका मेलबॉक्स खोलना अंततः विज्ञापन पत्रों को आकर्षित करेगा।)
बैकस्लैश
मार्कडाउन उन प्रतीकों को सम्मिलित करने के लिए बैकस्लैश का उपयोग कर सकता है जिनके व्याकरण में अन्य अर्थ हैं, उदाहरण के लिए: यदि आप जोर देने के लिए टेक्स्ट के आगे तारांकन जोड़ना चाहते हैं (लेकिन नहीं <em> टैग), आप बैकस्लैश के साथ तारांकन से पहले कर सकते हैं:
\*literal asterisks\*
मार्कडाउन सामान्य प्रतीकों को सम्मिलित करने में सहायता के लिए बैकस्लैश से पहले निम्नलिखित प्रतीकों का समर्थन करता है:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号मार्कडाउन मुक्त संपादक
विंडोज प्लेटफॉर्म
मैक मंच
ऑनलाइन संपादक
ब्राउज़र प्लगइन
*** अगर सिफारिश करने के लिए एक बेहतर मुफ्त मार्कडाउन संपादक है, तो कृपया प्रतिक्रिया पर ध्यान देंचेन वेइलियांग,धन्यवाद!
होप चेन वेइलियांग ब्लॉग ( https://www.chenweiliang.com/ ) ने साझा किया "मार्कडाउन का क्या अर्थ है? मार्कडाउन सिंटैक्स/स्वरूपण मार्कअप का उपयोग कैसे करें? , आपकी मदद के लिए।
इस लेख का लिंक साझा करने के लिए आपका स्वागत है:https://www.chenweiliang.com/cwl-482.html
नवीनतम अपडेट प्राप्त करने के लिए चेन वेइलियांग के ब्लॉग के टेलीग्राम चैनल में आपका स्वागत है!
📚 इस गाइड में बहुत महत्व है, 🌟यह एक दुर्लभ अवसर है, इसे न चूकें! ⏰⌛💨
अच्छा लगे तो शेयर और लाइक करें!
आपका साझा करना और पसंद करना हमारी निरंतर प्रेरणा है!