लेख निर्देशिका
चिन्हांकित करात्याचा अर्थ काय?
मार्कडाउन सिंटॅक्स/फॉर्मेटिंग मार्कअप कसे वापरावे?
आढावा
मार्कडाउन ही जॉन ग्रुबरने तयार केलेली लाइटवेट मार्कअप भाषा आहे.
हे लोकांना "वाचण्यास आणि लिहिण्यास सोपे असलेल्या साध्या मजकूर स्वरूपात दस्तऐवज लिहिण्याची आणि नंतर त्यांना वैध XHTML (किंवा HTML) दस्तऐवजांमध्ये रूपांतरित करण्यास" अनुमती देते.
भाषा ई-मेलमध्ये आधीच आढळलेल्या साध्या मजकूर मार्कअपची अनेक वैशिष्ट्ये समाविष्ट करते.
जॉन ग्रुबरने 2004 मध्ये, व्याकरणावर मोठ्या प्रमाणात अॅरॉन स्वार्ट्झच्या सहकार्याने मार्कडाउन भाषा तयार केली.भाषेचा उद्देश "वाचण्यास सोपे, लिहिण्यास सोपे आणि वैकल्पिकरित्या वैध XHTML (किंवा HTML) मध्ये रूपांतरित करणारे एक साधा मजकूर स्वरूप" वापरणे आहे.
उद्देश
मार्कडाउनचे ध्येय "वाचण्यास सोपे आणि लिहिण्यास सोपे" आहे.
वाचनीयता, तरीही ते कराइंटरनेट मार्केटिंग, वापरकर्ता अनुभव खूप महत्वाचा आहे.
मार्कडाउनमध्ये लिहिलेला दस्तऐवज थेट साध्या मजकुरात प्रकाशित केला जाऊ शकतो आणि तो अनेक टॅग किंवा फॉरमॅटिंग निर्देशांनी बनलेला दिसत नाही.
मार्कडाउन सिंटॅक्स काही विद्यमान टेक्स्ट-टू-एचटीएमएल फॉरमॅट्सद्वारे प्रभावित आहे, ज्यामध्ये Setext, atx, Textile, restructuredText, Grutatext आणि EtText समाविष्ट आहे, परंतु प्रेरणाचा सर्वात मोठा स्त्रोत म्हणजे साधा मजकूर ईमेल स्वरूप.
थोडक्यात, मार्कडाउनची वाक्यरचना सर्व चिन्हांनी बनलेली आहे, जी काळजीपूर्वक निवडलेली आहे आणि त्यांची कार्ये एका दृष्टीक्षेपात स्पष्ट आहेत.उदाहरणार्थ: मजकुराभोवती तारा लावा जेणेकरुन ते *भार* सारखे दिसावे.
मार्कडाउनमधील याद्या याद्यासारख्या दिसतात. मार्कडाउनमधील ब्लॉककोट्स खरोखर मजकूराचा तुकडा उद्धृत केल्यासारखे दिसतात, जसे की तुम्ही ईमेलमध्ये पाहिले आहे.
HTML सह सुसंगत
मार्कडाउन व्याकरणाचे उद्दिष्ट वेबसाठी लेखन भाषा असणे आहे.
मार्कडाउनचा अर्थ एचटीएमएल बदलण्यासाठी किंवा त्याच्या जवळ येण्यासाठी नाही, त्यात फारच कमी वाक्यरचना आहे आणि HTML मार्कअपच्या एका लहान उपसंचाशी संबंधित आहे. HTML दस्तऐवज लिहिणे सोपे करण्यासाठी मार्कडाउनची कल्पना नव्हती.
माझ्या मते, HTML आधीच लिहिणे सोपे आहे. दस्तऐवज वाचणे, लिहिणे आणि इच्छेनुसार बदलणे सोपे करणे ही मार्कडाउनची कल्पना आहे. HTML हे प्रकाशन स्वरूप आहे, मार्कडाउन आहे aकॉपीराइटिंगलिखित स्वरूप.जसे की, मार्कडाउनचे फॉरमॅटिंग सिंटॅक्स फक्त साधा मजकूर काय करू शकतो ते कव्हर करते.
मार्कडाउनमध्ये समाविष्ट नसलेले टॅग थेट दस्तऐवजात HTML मध्ये लिहिले जाऊ शकतातवेब प्रमोशनकॉपीहे HTML किंवा मार्कडाउन म्हणून चिन्हांकित करण्याची आवश्यकता नाही; फक्त मार्कअप थेट जोडा.
फक्त काही एचटीएमएल ब्लॉक घटक प्रतिबंधित केले जातील - जसे <div>,<table>,<pre>,<p> आणि इतर टॅग, ते आधी आणि नंतर रिक्त रेषा असलेल्या इतर सामग्री क्षेत्रांपासून वेगळे केले पाहिजेत आणि त्यांचे उघडणे आणि बंद होणारे टॅग टॅब किंवा स्पेससह इंडेंट केलेले नसावेत. मार्कडाउन जनरेटर अनावश्यक एचटीएमएल ब्लॉक टॅग जोडण्यासाठी पुरेसे स्मार्ट आहे <p> लेबल
मार्कडाउन फाइलमध्ये एचटीएमएल टेबल जोडणे हे उदाहरण खालीलप्रमाणे आहे:
这是一个普通段落。
<table>
<tr>
<td>Foo</td>
</tr>
</table>
这是另一个普通段落。
लक्षात ठेवा की HTML ब्लॉक टॅगमधील मार्कडाउन फॉरमॅटिंग सिंटॅक्सवर प्रक्रिया केली जाणार नाही.उदाहरणार्थ, जर तुम्ही HTML ब्लॉक्समध्ये मार्कडाउन शैली वापरत असाल*强调*परिणाम होणार नाही.
HTML विभाग (इनलाइन) टॅग जसे की <span>,<cite>,<del> मार्कडाउन परिच्छेद, सूची किंवा शीर्षकांमध्ये मुक्तपणे वापरले जाऊ शकते.वैयक्तिक सवयींनुसार, तुम्ही मार्कडाउन फॉरमॅट न वापरता फॉरमॅट करण्यासाठी HTML टॅग देखील वापरू शकता.उदाहरण: तुम्ही HTML ला प्राधान्य दिल्यास <a> 或 <img> टॅग, जे मार्कडाउनद्वारे प्रदान केलेल्या लिंक किंवा इमेज टॅग सिंटॅक्सशिवाय थेट वापरले जाऊ शकतात.
एचटीएमएल ब्लॉक टॅगच्या विपरीत, मार्कडाउन सिंटॅक्स एचटीएमएल विभाग टॅग दरम्यान वैध आहे.
विशेष वर्णांचे स्वयंचलित रूपांतरण
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 मानकांच्या प्रमाणीकरणाद्वारे आढळलेल्या त्रुटींची सर्वात मोठी संख्या आहे.
मार्कडाउन आपल्याला अक्षरे नैसर्गिकरित्या लिहिण्याची परवानगी देते आणि ते रूपांतरित करणे आवश्यक आहे याची काळजी घेते.आपण वापरत असल्यास & वर्ण हा 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
-------------
कोणतीही रक्कम = 和 - प्रभावी असू शकते.
Atx सारखा फॉर्म ओळीच्या सुरुवातीला 1 ते 6 घालतो # , शीर्षक 1 ते 6 शी संबंधित, उदाहरणार्थ:
# 这是 H1
## 这是 H2
###### 这是 H6
तुम्ही ऐटीक्स सारखी हेडर वैकल्पिकरित्या "बंद" करू शकता, हे पूर्णपणे सौंदर्यशास्त्रासाठी आहे, जर तुम्हाला अशा प्रकारे सोयीस्कर वाटत असेल, तर तुम्ही ते ओळीच्या शेवटी जोडू शकता. #, ओळ संपत असताना # संख्या सुरुवातीच्या सारखी असणे आवश्यक नाही (ओळीच्या सुरूवातीस पाउंड वर्णांची संख्या शीर्षकाचा क्रम निर्धारित करते):
# 这是 H1 #
## 这是 H2 ##
### 这是 H3 ######
ब्लॉककोट्स ब्लॉककोट्स
मार्कडाउन मार्कअप ब्लॉककोट्स ईमेलमध्ये वापरल्याप्रमाणेच वापरले जातात > उद्धरणांचे.जर तुम्ही ईमेल अक्षरांमधील अवतरणांशी परिचित असाल, तर तुम्हाला मार्कडाउन फाइलमध्ये ब्लॉक कोट कसा तयार करायचा हे माहित आहे, जे तुम्ही स्वतःच ओळी तोडल्यासारखे दिसेल, नंतर जोडा > :
> 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 स्त्रोत कोड घालण्यासाठी, फक्त कॉपी आणि पेस्ट करा, इंडेंटेशन जोडा आणि बाकीचे मार्कडाउन तुमच्यासाठी हाताळेल. उदाहरण:
<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" हे प्रतिमा संदर्भाचे नाव आहे, ज्याची व्याख्या दुव्याच्या संदर्भाप्रमाणेच केली जाते:
[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
नवीनतम अपडेट्स मिळवण्यासाठी चेन वेइलियांगच्या ब्लॉगच्या टेलिग्राम चॅनेलवर आपले स्वागत आहे!
📚 या मार्गदर्शकामध्ये प्रचंड मूल्य आहे, 🌟ही एक दुर्मिळ संधी आहे, ती चुकवू नका! ⏰⌛💨
आवडल्यास शेअर आणि लाईक करा!
तुमचे शेअरिंग आणि लाईक्स ही आमची सतत प्रेरणा आहे!