लेख निर्देशिका
छुटके मतलब?
मार्कडाउन सिन्ट्याक्स/ढाँचा मार्कअप कसरी प्रयोग गर्ने?
अवलोकन
मार्कडाउन जोन ग्रुबर द्वारा बनाईएको एक हल्का मार्कअप भाषा हो।
यसले मानिसहरूलाई "पढ्न र लेख्न सजिलो हुने सादा पाठ ढाँचामा कागजातहरू लेख्न, र त्यसपछि तिनीहरूलाई वैध XHTML (वा HTML) कागजातहरूमा रूपान्तरण गर्न" अनुमति दिन्छ।
भाषाले इ-मेलमा पहिले नै फेला परेका सादा पाठ मार्कअपका धेरै सुविधाहरू समावेश गर्दछ।
जोन ग्रुबरले 2004 मा मार्कडाउन भाषा सिर्जना गर्नुभयो, सिन्ट्याक्समा ठूलो भागमा आरोन स्वार्ट्जको सहयोगमा।भाषाको उद्देश्य "पढ्न सजिलो, लेख्न सजिलो, र वैकल्पिक रूपमा मान्य XHTML (वा HTML) मा रूपान्तरण गर्ने सादा पाठ ढाँचा" प्रयोग गर्नु हो।
उद्देश्य
मार्कडाउनको लक्ष्य "पढ्न सजिलो र लेख्न सजिलो" हुनु हो।
पठनीयता, जसरी पनि गर्नुहोस्网络 营销, प्रयोगकर्ता अनुभव धेरै महत्त्वपूर्ण छ।
मार्कडाउनमा लेखिएको फाइल सादा पाठमा सीधा प्रकाशित गर्न सक्षम हुनुपर्छ, र धेरै ट्यागहरू वा ढाँचा निर्देशनहरू समावेश भएको देखिँदैन।
मार्कडाउन सिन्ट्याक्स केही अवस्थित पाठ-देखि-HTML ढाँचाहरूद्वारा प्रभावित हुन्छ, जसमा Setext, atx, Textile, restructuredText, Grutatext, र EtText, तर प्रेरणाको सबैभन्दा ठूलो स्रोत सादा पाठ इमेल ढाँचा हो।
छोटकरीमा, मार्कडाउनको वाक्यविन्यास सबै प्रतीकहरूबाट बनेको हुन्छ, जुन ध्यानपूर्वक चयन गरिएको छ र तिनीहरूका कार्यहरू एक नजरमा स्पष्ट छन्।उदाहरणका लागि: पाठको वरिपरि ताराहरू राख्नुहोस् यसलाई *जोर* जस्तो देखिन।
मार्कडाउनमा सूचीहरू जस्तै देखिन्छ, राम्रो, सूचीहरू। मार्कडाउनमा ब्लककोटहरू वास्तवमा पाठको टुक्रा उद्धृत गरेजस्तै देखिन्छ, जस्तै तपाईंले इमेलहरूमा देख्नुभएको छ।
HTML संग उपयुक्त
मार्कडाउन व्याकरणको लक्ष्य वेबको लागि लेखन भाषा हुनु हो।
मार्कडाउन HTML लाई प्रतिस्थापन गर्न वा यसको नजिक आउनको लागि होइन, यसमा धेरै कम वाक्य रचना भिन्नताहरू छन् र केवल HTML मार्कअपको सानो उपसेटसँग मेल खान्छ। मार्कडाउन HTML कागजातहरू लेख्न सजिलो बनाउनको लागि कल्पना गरिएको थिएन।
मेरो विचारमा, HTML पहिले नै लेख्न सजिलो छ। मार्कडाउनको विचार भनेको कागजातहरू पढ्न, लेख्न र इच्छा अनुसार परिवर्तन गर्न सजिलो बनाउनु हो। HTML एक प्रकाशन ढाँचा हो, मार्कडाउन एक होकपिराइटि।लिखित ढाँचा।जस्तै, मार्कडाउनको ढाँचा सिन्ट्याक्सले सादा पाठले गर्न सक्ने कुरा मात्र समावेश गर्दछ।
मार्कडाउन द्वारा कभर नगरिएका ट्यागहरू सीधा कागजातमा HTML मा लेख्न सकिन्छवेब पदोन्नतिकापी।यसलाई HTML वा मार्कडाउनको रूपमा चिन्ह लगाउन आवश्यक छैन; केवल मार्कअप सिधै थप्नुहोस्।
केवल केहि HTML ब्लक तत्वहरू सीमित हुन - जस्तै <div>,<table>,<pre>,<p> र अन्य ट्यागहरू, तिनीहरू पहिले र पछि खाली रेखाहरू भएका अन्य सामग्री क्षेत्रहरूबाट अलग हुनुपर्छ, र तिनीहरूको खोल्ने र बन्द हुने ट्यागहरू ट्याब वा स्पेसहरूसँग इन्डेन्ट गरिएको हुनु हुँदैन। मार्कडाउन जेनेरेटर अनावश्यक HTML ब्लक ट्यागहरू थप्न पर्याप्त स्मार्ट छ <p> लेबल
उदाहरण निम्नानुसार छ, मार्कडाउन फाइलमा HTML तालिका थप्दै:
这是一个普通段落。
<table>
<tr>
<td>Foo</td>
</tr>
</table>
这是另一个普通段落。
नोट गर्नुहोस् कि HTML ब्लक ट्यागहरू बीचको मार्कडाउन ढाँचा सिन्ट्याक्स प्रशोधन गरिने छैन।उदाहरण को लागी, यदि तपाइँ HTML ब्लक भित्र मार्कडाउन शैली प्रयोग गर्नुहुन्छ*强调*कुनै प्रभाव हुनेछैन।
HTML खण्ड (इनलाइन) ट्यागहरू जस्तै <span>,<cite>,<del> मार्कडाउन अनुच्छेद, सूची वा शीर्षकहरूमा स्वतन्त्र रूपमा प्रयोग गर्न सकिन्छ।व्यक्तिगत बानीहरू अनुसार, तपाईले मार्कडाउन ढाँचा प्रयोग नगरी ढाँचामा HTML ट्यागहरू पनि प्रयोग गर्न सक्नुहुन्छ।उदाहरण: यदि तपाइँ एचटीएमएल रुचाउनुहुन्छ <a> वा <img> ट्यागहरू, जुन मार्कडाउन द्वारा प्रदान गरिएको लिङ्क वा छवि ट्याग सिन्ट्याक्स बिना सीधा प्रयोग गर्न सकिन्छ।
HTML ब्लक ट्यागहरू बीचको विपरीत, मार्कडाउन सिन्ट्याक्स HTML खण्ड ट्यागहरू बीच मान्य छ।
विशेष वर्णहरूको स्वचालित रूपान्तरण
HTML फाइलहरूमा, त्यहाँ दुईवटा क्यारेक्टरहरू छन् जसलाई विशेष ह्यान्डलिङ चाहिन्छ: < 和 & । < प्रतीकहरू स्टार्ट ट्यागहरूको लागि प्रयोग गरिन्छ,& प्रतीकहरू HTML संस्थाहरूलाई चिन्ह लगाउन प्रयोग गरिन्छ, यदि तपाईं यी क्यारेक्टरहरूको प्रोटोटाइप मात्र प्रदर्शन गर्न चाहनुहुन्छ भने, तपाईंले इकाई फारम प्रयोग गर्नुपर्छ, जस्तै < 和 &।
& क्यारेक्टरहरू विशेष गरी वेब कागजात लेखकहरूको लागि पीडादायी छन्, यदि तपाइँ टाइप गर्न जाँदै हुनुहुन्छ भने "AT&T", तपाईले लेख्नु पर्छ"AT&T"।URL मा हुँदा & पात्रहरू पनि रूपान्तरण हुन्छन्।उदाहरण को लागी तपाइँ लिङ्क गर्न चाहानुहुन्छ:
http://images.google.com/images?num=30&q=larry+bird
तपाईंले URL रूपान्तरण निम्न रूपमा लेख्नुपर्छ:
http://images.google.com/images?num=30&q=larry+bird
लिङ्क ट्यागमा राख्नु पर्छ href गुणहरूमा।भन्न आवश्यक छैन, यो बेवास्ता गर्न सजिलो छ, र सम्भवतः HTML मापदण्ड प्रमाणीकरण द्वारा पत्ता लगाइएको त्रुटिहरूको सबैभन्दा ठूलो संख्या हो।
मार्कडाउनले तपाईंलाई क्यारेक्टरहरू स्वाभाविक रूपमा लेख्न अनुमति दिन्छ, र यसले के रूपान्तरण गर्न आवश्यक छ भन्ने कुराको ख्याल राख्छ।यदि तपाइँ प्रयोग गर्नुहुन्छ & क्यारेक्टर एचटीएमएल क्यारेक्टर एकाईको अंश हो, यसलाई जसरी नै छोडिन्छ, अन्यथा यसलाई रूपान्तरण गरिन्छ &;।
त्यसैले यदि तपाइँ कागजातमा प्रतिलिपि अधिकार प्रतीक सम्मिलित गर्न चाहनुहुन्छ भने ©, तपाईं लेख्न सक्नुहुन्छ:
©
मार्कडाउनले यसलाई अछुतो छोड्नेछ।र यदि तपाइँ लेख्नुहुन्छ:
AT&T
मार्कडाउनले यसलाई रूपान्तरण गर्नेछ:
AT&T
मा पनि यस्तै अवस्था छ < नोटेशन, किनकि मार्कडाउनले HTML अनुकूलतालाई अनुमति दिन्छ, यदि तपाईंले राख्नुभयो भने < प्रतीकहरू HTML ट्यागहरूको लागि सीमांककको रूपमा प्रयोग गरिन्छ, र मार्कडाउनले तिनीहरूमा कुनै रूपान्तरण गर्दैन, तर यदि तपाईंले लेख्नुभयो भने:
4 < 5
मार्कडाउनले यसलाई रूपान्तरण गर्नेछ:
4 < 5
यद्यपि, यो नोट गर्नुपर्छ कि कोडको दायरा भित्र, चाहे यो इनलाइन वा ब्लक होस्, < 和 & दुवै प्रतीकनिश्चित रूपमाHTML संस्थाहरूमा रूपान्तरण गरिन्छ, एउटा विशेषता जसले तपाईंलाई सजिलैसँग मार्कडाउनमा HTML कोड लेख्न अनुमति दिन्छ (HTML को विपरीत, जहाँ तपाईंले सबै राख्नुहुन्छ। < 和 & HTML फाइलमा HTML कोड लेख्नको लागि सबै HTML संस्थाहरूमा रूपान्तरण गरिन्छ। )
ब्लक तत्व
अनुच्छेद र लाइन ब्रेक
मार्कडाउन अनुच्छेदमा पाठको एक वा बढी लगातार लाइनहरू समावेश हुन्छन्, अघिल्लो र एकभन्दा बढी खाली रेखाहरू (खाली रेखाको परिभाषा यो हो कि यो प्रदर्शनमा खाली देखिन्छ र खाली रेखा मानिन्छ। उदाहरणका लागि, , यदि रेखाले खाली ठाउँ र ट्याबहरू मात्र समावेश गर्दछ भने, रेखालाई खाली रेखाको रूपमा पनि मानिनेछ)।सामान्य अनुच्छेदहरू खाली ठाउँ वा ट्याबहरूसँग इन्डेन्ट गरिएको हुनु हुँदैन।
वाक्यांश "पाठको एक वा बढी लगातार लाइनहरू समावेश गर्दछ" वास्तवमा संकेत गर्दछ कि मार्कडाउनले अनुच्छेदहरू भित्र जबरजस्ती नयाँलाइनहरू (नयाँलाइनहरू सम्मिलित गर्न) अनुमति दिन्छ, एउटा विशेषता जुन धेरै अन्य पाठ-देखि-HTML ढाँचाहरू भन्दा फरक छ (जस्तै चल्ने प्रकार "रूपान्तरण लाइन ब्रेकहरू सहित)। "विकल्प), अन्य ढाँचाहरूले प्रत्येक लाइन ब्रेकमा रूपान्तरण गर्नेछ <br /> लेबल
यदि तिमीवास्तवमासम्मिलित गर्न मार्कडाउनमा भर पर्न चाहनुहुन्छ <br /> लेबलहरूको लागि, सम्मिलित स्थानमा दुई वा बढी खाली ठाउँहरू थिच्नुहोस् र त्यसपछि इन्टर थिच्नुहोस्।
वास्तवमा, यसले उत्पन्न गर्न अलि बढी काम (अतिरिक्त ठाउँहरू) लिन्छ <br /> , तर केवल "प्रत्येक नयाँ लाइनमा रूपान्तरण हुन्छ <br />"विधि मार्कडाउनमा उपयुक्त छैन, मार्कडाउनमाaiL-शैली ब्लककोटहरू र बहु-अनुच्छेद सूचीहरू अधिक उपयोगी मात्र होइन तर लाइन ब्रेकहरूसँग टाइपसेट गर्दा पढ्न सजिलो पनि छन्।
शीर्षक
मार्कडाउनले हेडिङका लागि दुई वाक्यविन्यासहरूलाई समर्थन गर्दछ, Setext-like र atx-like।
Settext-जस्तो फारम तल्लो रेखा भएको फारम हो, प्रयोग गरेर = (उच्चतम शीर्षक) र - (दोस्रो अर्डर शीर्षकहरू), उदाहरणका लागि:
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 मार्कअप हुनेछ:
<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"
तपाइँ अर्को लाइनमा शीर्षक विशेषता पनि राख्न सक्नुहुन्छ, वा केहि इन्डेन्टेसन थप्न सक्नुहुन्छ, जुन URL धेरै लामो छ भने राम्रो देखिनेछ:
[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 ढाँचामा, पाठ भन्दा धेरै ट्यागहरू छन्।
मार्कडाउनको सन्दर्भ-शैली लिङ्कहरू प्रयोग गरेर, तपाईंले कागजातलाई ब्राउजरको अन्तिम नतिजा जस्तै बनाउन सक्नुहुन्छ, तपाईंलाई अनुच्छेद पाठ बाहिर मार्कअप-सम्बन्धित मेटाडेटा सार्न अनुमति दिँदै, र तपाईंले लेखको पढाइको अनुभूति नगरी लिङ्कहरू थप्न सक्नुहुन्छ। ।
जोड दिनुहोस्
मार्कडाउन ताराहरू प्रयोग गर्दछ (*) र तल्लो रेखा (_) अधोरेखित शब्द चिन्ह लगाउन प्रतीकको रूपमा, हो * वा _ घेरिएका शब्दहरूमा रूपान्तरण गरिन्छ <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>
图片
स्पष्ट रूपमा, पाठ-मात्र अनुप्रयोगमा छविहरू सम्मिलित गर्नको लागि "प्राकृतिक" वाक्यविन्यास डिजाइन गर्न गाह्रो छ।
मार्कडाउनले तस्बिरहरू चिन्ह लगाउन लिङ्कहरू जस्तै सिन्ट्याक्स प्रयोग गर्दछ, र दुई शैलीहरूलाई पनि अनुमति दिन्छ: क्रममा和सन्दर्भ।
इनलाइन छवि सिन्ट्याक्स यस्तो देखिन्छ:
विवरणहरू निम्नानुसार छन्:
- एक विस्मयादिबोधक चिन्ह
! - छविको लागि alt पाठको साथ वर्गाकार कोष्ठक पछि
- यो छविको 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
नवीनतम अपडेटहरू प्राप्त गर्न चेन वेइलियाङको ब्लगको टेलिग्राम च्यानलमा स्वागत छ!
📚 यो गाइडले ठूलो मूल्य समावेश गर्दछ, 🌟यो दुर्लभ अवसर हो, यसलाई नछुटाउनुहोस्! ⏰⌛💨
मन परे लाइक र सेयर गर्नुहोस !
तपाइँको साझा र लाइक हाम्रो निरन्तर प्रेरणा हो!