სტატიების დირექტორია
MarkdownᲠას ნიშნავს?
როგორ გამოვიყენოთ Markdown სინტაქსი/ფორმატირების მარკირება?
მიმოხილვა
Markdown არის მსუბუქი მარკირების ენა, შექმნილი ჯონ გრუბერის მიერ.
ეს საშუალებას აძლევს ადამიანებს „დაწერონ დოკუმენტები მარტივი ტექსტის ფორმატში, რომელიც ადვილად იკითხება და წერია და შემდეგ გადააქვთ ისინი მოქმედ XHTML (ან HTML) დოკუმენტებად“.
ენა აერთიანებს უბრალო ტექსტის მარკირების ბევრ მახასიათებელს, რომელიც უკვე ნაპოვნია ელ. ფოსტაში.
ჯონ გრუბერმა შექმნა მარკდაუნის ენა 2004 წელს, აარონ სვარცთან თანამშრომლობით, დიდწილად სინტაქსზე.ენის მიზანია გამოიყენოს "მარტივი ტექსტის ფორმატი, რომელიც ადვილად იკითხება, ადვილად იწერება და სურვილისამებრ გარდაიქმნება მოქმედ XHTML-ში (ან HTML)".
დანიშნულება
Markdown-ის მიზანია იყოს "ადვილი წასაკითხი და ადვილად დასაწერი".
წაკითხვის უნარი, გააკეთე მაინცინტერნეტ მარკეტინგი, მომხმარებლის გამოცდილება ძალიან მნიშვნელოვანია.
Markdown-ში დაწერილი დოკუმენტი უნდა გამოქვეყნდეს პირდაპირ უბრალო ტექსტში და არ უნდა იყოს შედგენილი მრავალი ტეგით ან ფორმატირების დირექტივებით.
Markdown სინტაქსზე გავლენას ახდენს ზოგიერთი არსებული ტექსტის HTML ფორმატები, მათ შორის Setext, atx, Textile, reStructuredText, Grutatext და EtText, მაგრამ შთაგონების ყველაზე დიდი წყარო არის მარტივი ტექსტური ელფოსტის ფორმატი.
მოკლედ, მარკდაუნის სინტაქსი შედგება სიმბოლოებისგან, რომლებიც საგულდაგულოდ არის შერჩეული და მათი ფუნქციები ერთი შეხედვით ნათელია.მაგალითად: დაადეთ ვარსკვლავები ტექსტის გარშემო, რათა გამოიყურებოდეს *ხაზგასმა*.
სიები Markdown-ში ჰგავს სიებს. ბლოკციტატები Markdown-ში ნამდვილად ჰგავს ტექსტის ციტირებას, ისევე როგორც თქვენ ნახეთ ელ.წერილებში.
თავსებადია HTML-თან
Markdown-ის გრამატიკის მიზანია იყოს წერის ენა ინტერნეტისთვის.
Markdown არ არის გამიზნული HTML-ის ჩანაცვლებისთვის, ან თუნდაც მასთან მიახლოების მიზნით, მას აქვს ძალიან ცოტა ტიპის სინტაქსი და შეესაბამება HTML მარკირების მხოლოდ მცირე ქვეჯგუფს. Markdown არ იყო ჩაფიქრებული HTML დოკუმენტების დასაწერად.
ჩემი აზრით, HTML უკვე ადვილი დასაწერია. Markdown-ის იდეა არის დოკუმენტების წაკითხვა, ჩაწერა და სურვილისამებრ შეცვლა. HTML არის საგამომცემლო ფორმატი, Markdown არის აკოპირებაწერილობითი ფორმატი.როგორც ასეთი, Markdown-ის ფორმატირების სინტაქსი მოიცავს მხოლოდ იმას, რაც შეუძლია უბრალო ტექსტს.
ტეგები, რომლებიც არ არის დაფარული Markdown-ით, შეიძლება დაიწეროს HTML-ში პირდაპირ დოკუმენტშივებ პოპულარიზაციაკოპირება.არ არის საჭირო ამის მონიშვნა, როგორც HTML ან Markdown; უბრალოდ დაამატეთ მარკირება პირდაპირ.
მხოლოდ ზოგიერთი HTML ბლოკის ელემენტი უნდა შეიზღუდოს - მაგ <div>,<table>,<pre>,<p> და სხვა ტეგები, ისინი უნდა იყოს გამოყოფილი სხვა შინაარსის არეებისგან ცარიელი ხაზებით ადრე და მის შემდეგ, და მათი გახსნისა და დახურვის ტეგები არ უნდა იყოს ჩაჭრილი ჩანართებით ან ინტერვალით. Markdown გენერატორი საკმარისად ჭკვიანია, რომ არ დაამატოთ არასაჭირო HTML ბლოკის ტეგები <p> ლეიბლი.
მაგალითი შემდეგია, HTML ცხრილის დამატება Markdown ფაილში:
这是一个普通段落。
<table>
<tr>
<td>Foo</td>
</tr>
</table>
这是另一个普通段落。
გაითვალისწინეთ, რომ Markdown ფორმატირების სინტაქსი HTML ბლოკის ტეგებს შორის არ დამუშავდება.მაგალითად, თუ იყენებთ Markdown სტილს HTML ბლოკში*强调*არანაირი ეფექტი არ ექნება.
HTML განყოფილების (inline) ტეგები, როგორიცაა <span>,<cite>,<del> შეიძლება თავისუფლად გამოიყენოთ Markdown აბზაცებში, სიებში ან სათაურებში.პირადი ჩვევების მიხედვით, თქვენ შეგიძლიათ გამოიყენოთ HTML ტეგები ფორმატირებისთვის Markdown ფორმატის გამოყენების გარეშე.მაგალითი: თუ გირჩევნიათ HTML <a> 或 <img> ტეგები, რომლებიც შეიძლება გამოყენებულ იქნას უშუალოდ Markdown-ის მიერ მოწოდებული ბმულის ან გამოსახულების ტეგის სინტაქსის გარეშე.
HTML ბლოკის ტეგებისგან განსხვავებით, Markdown სინტაქსი მოქმედებს 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 სტანდარტების დადასტურებით.
Markdown გაძლევთ საშუალებას დაწეროთ სიმბოლოები ბუნებრივად და ის ზრუნავს იმაზე, თუ რა უნდა გადაკეთდეს.თუ იყენებთ & სიმბოლო არის HTML სიმბოლოს ერთეულის ნაწილი, ის რჩება როგორც არის, წინააღმდეგ შემთხვევაში ის გარდაიქმნება &;.
ასე რომ, თუ გსურთ დოკუმენტში საავტორო უფლებების სიმბოლოს ჩასმა ©, შეგიძლიათ დაწეროთ:
©
მარკდაუნი მას ხელუხლებლად დატოვებს.და თუ დაწერ:
AT&T
Markdown გადააქცევს მას:
AT&T
ანალოგიური სიტუაციაა ასევე < ნოტაცია, ვინაიდან Markdown იძლევა HTML თავსებადობას, თუ დააყენებთ < სიმბოლოები გამოიყენება როგორც HTML ტეგების გამსაზღვრელი და Markdown არ გააკეთებს რაიმე კონვერტაციას მათზე, მაგრამ თუ დაწერთ:
4 < 5
Markdown გადააქცევს მას:
4 < 5
თუმცა, უნდა აღინიშნოს, რომ კოდის ფარგლებში, იქნება ეს inline თუ დაბლოკილი, < 和 & ორივე სიმბოლოუნდაგარდაიქმნება HTML ერთეულებად, ფუნქცია, რომელიც საშუალებას გაძლევთ მარტივად დაწეროთ HTML კოდი Markdown-ში (განსხვავებით HTML-ისგან, სადაც თქვენ განათავსებთ ყველა < 和 & ყველა გარდაიქმნება HTML ერთეულებად, რათა ჩაიწეროს HTML კოდი HTML ფაილში. )
ბლოკის ელემენტი
აბზაცები და სტრიქონების წყვეტები
Markdown აბზაცი შედგება ტექსტის ერთი ან მეტი თანმიმდევრული სტრიქონისგან, რომელსაც წინ უძღვის და მოჰყვება ერთზე მეტი ცარიელი ხაზი (ცარიელი ხაზის განმარტება არის ის, რომ ის ცარიელია ეკრანზე და ითვლება ცარიელ ხაზად. მაგალითად, , თუ ხაზი შეიცავს მხოლოდ ინტერვალებს და ჩანართებს, ხაზი ასევე განიხილება როგორც ცარიელი ხაზი).ჩვეულებრივი აბზაცები არ უნდა იყოს ჩაჭრილი ინტერვალით ან ჩანართებით.
ფრაზა "შედგება ტექსტის ერთი ან მეტი თანმიმდევრული სტრიქონისგან" რეალურად გულისხმობს, რომ Markdown საშუალებას აძლევს იძულებით ახალ ხაზებს (ახალი ხაზების ჩასმა) აბზაცებში, ფუნქცია, რომელიც განსხვავდება ტექსტის HTML ფორმატების უმეტესობისგან (მოძრავი ტიპის "Convert Line Breaks" ჩათვლით. " ვარიანტი), სხვა ფორმატები გადააქცევს თითოეულ ხაზს <br /> ლეიბლი.
Თუ შენნამდვილადგსურთ დაეყრდნოთ Markdown-ს ჩასასმელად <br /> ლეიბლებისთვის დააჭირეთ ორ ან მეტ სივრცეს ჩასმის ადგილას და შემდეგ დააჭირეთ Enter.
მართლაც, გენერირებას ცოტა მეტი სამუშაო (დამატებითი სივრცეები) სჭირდება <br /> , მაგრამ უბრალოდ "თითოეული ახალი ხაზი გარდაიქმნება <br />” მეთოდი არ არის შესაფერისი Markdown-ში Em in MarkdownaiL-ის სტილის ბლოკის მითითებები და მრავალაბზაციანი სიები არა მხოლოდ უფრო სასარგებლოა, არამედ უფრო ადვილად იკითხება ფორმატირებისთვის ხაზების წყვეტების გამოყენებისას.
სათაური
Markdown მხარს უჭერს ორ სინტაქსს სათაურებისთვის, Setext-ის მსგავსი და atx-ის მსგავსი.
Settext-ის მსგავსი ფორმა არის ფორმა ქვედა ხაზით, გამოყენებით = (უმაღლესი სათაური) და - (მეორე რიგის სათაურები), მაგალითად:
This is an H1
=============
This is an H2
-------------
ნებისმიერი თანხა = 和 - შეიძლება ეფექტური იყოს.
Atx-ის მსგავსი ფორმა ჩასმულია 1-დან 6-მდე სტრიქონის დასაწყისში # 1-დან 6-მდე სათაურების შესაბამისი, მაგალითად:
# 这是 H1
## 这是 H2
###### 这是 H6
თქვენ შეგიძლიათ სურვილისამებრ "დახუროთ" atx-ის მსგავსი სათაურები, ეს მხოლოდ ესთეტიკისთვისაა, თუ თავს კომფორტულად გრძნობთ ამ გზით, შეგიძლიათ დაამატოთ ის ხაზის ბოლოს. #, ხოლო ხაზის დაბოლოება # რიცხვი არ უნდა იყოს იგივე, რაც დასაწყისი (სტრიქონის დასაწყისში ფუნტის სიმბოლოების რაოდენობა განსაზღვრავს სათაურის თანმიმდევრობას):
# 这是 H1 #
## 这是 H2 ##
### 这是 H3 ######
ბლოკციტატები ბლოკციტატები
Markdown მარკირების ბლოკციტატები გამოიყენება ელ.ფოსტის საშუალებით გამოყენებულის მსგავსად > ციტატების.თუ იცნობთ ციტატებს ელ.ფოსტის წერილებში, თქვენ იცით, როგორ შექმნათ ბლოკის ციტატა Markdown ფაილში, რომელიც გამოიყურება ისე, როგორც თქვენ თავად არღვევთ ხაზებს და შემდეგ დაამატეთ > :
> 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.
Markdown ასევე საშუალებას გაძლევთ იყოთ ზარმაცი და დაამატოთ მხოლოდ პირველი სტრიქონი მთელი აბზაცის > :
> 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.
სხვა Markdown სინტაქსები ასევე შეიძლება გამოყენებულ იქნას ციტირებულ ბლოკებში, მათ შორის სათაურები, სიები, კოდის ბლოკები და ა.შ.:
> ## 这是一个标题。
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
> 给出一些例子代码：
>
> return shell_exec("echo $input | $markdown_script");
ნებისმიერ კარგ ტექსტურ რედაქტორს შეუძლია ადვილად შექმნას ელ.ფოსტის სტილის ციტატები.მაგალითად, BBEdit-ში შეგიძლიათ აირჩიოთ ტექსტი და შემდეგ აირჩიოთ მენიუდანციტირების იერარქიის გაზრდა.
列表
Markdown მხარს უჭერს შეკვეთილ და შეუკვეთებელ სიებს.
უწესრიგო სიები იყენებენ ვარსკვლავებს, პლუს ნიშნებს ან მინუს ნიშნებს, როგორც სიის მარკერებს:
* 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 გამომავალს.საქმე იმაშია, რომ Markdown-ის ფაილში სიის ნომრები შეიძლება ისეთივე იყოს, როგორც გამომავალი შედეგები, ან თუ ზარმაცი ხარ, საერთოდ არ უნდა აინტერესებდე ციფრების სისწორეზე.
თუ იყენებთ ზარმაცი წერას, რეკომენდებულია პირველი პუნქტის დაწყება 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.
თუ სიის ელემენტები გამოყოფილია ცარიელი ხაზებით, Markdown გამოიყენებს ელემენტის შინაარსს 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.
ბევრად უკეთესად გამოიყურება, თუ თითოეულ სტრიქონს შეხეტავთ, რა თქმა უნდა, ისევ, თუ ზარმაცი ხართ, Markdown ასევე იძლევა საშუალებას:
* 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.
კოდის ბლოკი
პროგრამასთან დაკავშირებულ წერილობით ან თეგების ენის საწყის კოდს, როგორც წესი, აქვს უკვე აკრეფილი კოდის ბლოკები. ჩვეულებრივ, ჩვენ არ გვსურს, რომ ეს ბლოკები იყოს ტიპიური აბზაცის ზოგადი ფაილების სახით, მაგრამ გამოვაჩინოთ ისინი ისე, როგორც არის. Markdown გამოიყენებს <pre> 和 <code> ტეგები კოდის ბლოკების შესაფუთად.
კოდის ბლოკების შექმნა Markdown-ში ისეთივე მარტივია, როგორც 4 სივრცის ან 1 ჩანართის შეწევა. მაგალითად, შეიყვანეთ შემდეგი:
这是一个普通段落：
这是一个代码区块。
Markdown გარდაიქმნება:
<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 ერთეულებად. ეს მეთოდი გაგიადვილებთ Markdown-ის გამოყენებას მაგალითად HTML წყაროს კოდის ჩასართავად, უბრალოდ დააკოპირეთ და ჩასვით, დაამატეთ შეწევა და დანარჩენს Markdown გაუმკლავდება მას, მაგალითი:
<div class="footer">
© 2004 Foo Corporation
</div>
გარდაიქმნება:
<pre><code><div class="footer">
© 2004 Foo Corporation
</div>
</code></pre>
კოდის ბლოკში, Markdown-ის ზოგადი სინტაქსი არ გარდაიქმნება, მაგალითად, ვარსკვლავი მხოლოდ ვარსკვლავია, რაც ნიშნავს, რომ თქვენ შეგიძლიათ მარტივად ჩაწეროთ Markdown სინტაქსის დაკავშირებული ფაილები Markdown სინტაქსში.
გამყოფი
თქვენ შეგიძლიათ გამოიყენოთ სამზე მეტი ვარსკვლავი, მინუს ნიშნები, ხაზგასმული ხაზის გამყოფის შესაქმნელად, ხაზში სხვა არაფერი.თქვენ ასევე შეგიძლიათ ჩასვათ სივრცეები ვარსკვლავებს ან მინუს ნიშნებს შორის.განცალკევების ხაზები შეიძლება შეიქმნას წერის ყოველი შემდეგი გზით:
* * *
***
*****
- - -
---------------------------------------
განყოფილების ელემენტი
ბმული
Markdown მხარს უჭერს ბმულის სინტაქსის ორ ფორმას: Ხაზში和მითითებაორი ფორმა.
ნებისმიერ შემთხვევაში, ბმულის ტექსტი აღინიშნება [კვადრატული ფრჩხილებით].
შექმნას აᲮაზშითუ გსურთ დაამატოთ ბმულის სათაურის ტექსტი, უბრალოდ გადაიტანეთ სათაურის ტექსტი 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>
ქვემოთ მოცემულია იგივე შინაარსის Markdown ფაილი, რომელიც დაწერილია შედარებისთვის:
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 ფორმატში უფრო მეტი ტეგია ვიდრე ტექსტი.
Markdown-ის მითითების სტილის ბმულების გამოყენებით, შეგიძლიათ დოკუმენტი უფრო დაემსგავსოთ ბრაუზერის საბოლოო შედეგს, რაც საშუალებას მოგცემთ გადაიტანოთ მარკირებასთან დაკავშირებული მეტამონაცემები აბზაცის ტექსტის გარეთ და შეგიძლიათ დაამატოთ ბმულები სტატიის წაკითხვის გარეშე. შეწყვიტოთ .
强调
მარკდაუნი იყენებს ვარსკვლავებს (*) და ქვედა ხაზი (_) როგორც სიმბოლო ხაზგასმული სიტყვის აღსანიშნავად, არის * 或 _ გარშემორტყმული სიტყვები გარდაიქმნება <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 კოდის ჩასმას, Markdown დააყენებს შემდეგ აბზაცს:
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>
图片
ცხადია, ძნელია შექმნას "ბუნებრივი" სინტაქსი სურათების მხოლოდ ტექსტურ აპლიკაციაში ჩასართავად.
Markdown იყენებს ბმულების მსგავს სინტაქსს სურათების აღსანიშნავად და ასევე საშუალებას აძლევს ორ სტილს: Ხაზში和მითითება.
გამოსახულების შიდა სინტაქსი ასე გამოიყურება:
დეტალები ასეთია:
- ძახილის ნიშანი
! - მოჰყვება კვადრატული ფრჩხილის ალტერნატიული ტექსტი გამოსახულებისთვის
- ამას მოჰყვება ჩვეულებრივი ფრჩხილები გამოსახულების URL-ით და ბოლოს ბრჭყალებში ჩასმული არასავალდებულო „სათაურის“ ტექსტი.
საცნობარო გამოსახულების სინტაქსი ასე გამოიყურება:
![Alt text][id]
"id" არის სურათის მითითების სახელი, რომელიც განისაზღვრება ისევე, როგორც ბმულის მითითება:
[id]: url/to/image "Optional title attribute"
ჯერჯერობით Markdown-ს არ აქვს გამოსახულების სიგანე და სიმაღლის დაზუსტების საშუალება, საჭიროების შემთხვევაში შეგიძლიათ გამოიყენოთ ნორმალური <img> ლეიბლი.
其它
ავტო ბმული
Markdown მხარს უჭერს URL-ების და ელფოსტის საფოსტო ყუთების დამუშავებას შედარებით მოკლე ავტომატური ბმულების სახით. სანამ ისინი ჩასმულია კუთხის ფრჩხილებში, Markdown ავტომატურად გადააქცევს მას ბმულად.ზოგადი URL-ის ბმულის ტექსტი იგივეა, რაც ბმულის მისამართი, მაგალითად:
<http://example.com/>
Markdown გარდაიქმნება:
<a href="http://example.com/">http://example.com/</a>
ელ.ფოსტის მისამართების ავტომატური დაკავშირება ასევე მსგავსია, გარდა იმისა, რომ Markdown პირველ რიგში შეასრულებს კოდირების კონვერტაციის პროცესს, ტექსტის სიმბოლოების თექვსმეტობით 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]" ბმული, რომელიც შეიძლება დააწკაპუნოთ.
(მიუხედავად იმისა, რომ ამ მიდგომამ შეიძლება მოატყუოს ბევრი რობოტი, ყველას ვერ შეაჩერებს, მაგრამ არაფერს ჯობია. ნებისმიერ შემთხვევაში, თქვენი საფოსტო ყუთის გახსნა საბოლოოდ მიიზიდავს სარეკლამო წერილებს.)
უკანა ხაზი
Markdown-ს შეუძლია გამოიყენოს უკანა ხაზები გრამატიკაში სხვა მნიშვნელობის მქონე სიმბოლოების ჩასართავად, მაგალითად: თუ გსურთ დაამატოთ ვარსკვლავი ტექსტის გვერდით ხაზგასმისთვის (მაგრამ არა <em> tag), შეგიძლიათ წინ უსწროთ ვარსკვლავს უკანა ხაზით:
\*literal asterisks\*
Markdown მხარს უჭერს შემდეგ სიმბოლოებს, რომლებსაც წინ უძღვის უკანა ხაზი, რათა დაეხმაროს საერთო სიმბოლოების ჩასმას:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号Markdown უფასო რედაქტორი
Windows პლატფორმა
Mac პლატფორმა
ონლაინ რედაქტორი
ბრაუზერის მოდული
*** თუ არსებობს Markdown-ის უკეთესი უფასო რედაქტორის რეკომენდაცია, გთხოვთ, ყურადღება მიაქციოთ გამოხმაურებასჩენ ვეილიანგი,Გმადლობთ!
იმედი ჩენ ვეილიანგის ბლოგი ( https://www.chenweiliang.com/ ) გააზიარა „რას ნიშნავს მარკდაუნი? როგორ გამოვიყენოთ Markdown სინტაქსი/ფორმატირების მარკირება? , რომ დაგეხმარო.
კეთილი იყოს თქვენი მობრძანება ამ სტატიის ბმულის გასაზიარებლად:https://www.chenweiliang.com/cwl-482.html
კეთილი იყოს თქვენი მობრძანება Chen Weiliang-ის ბლოგის ტელეგრამის არხზე, რომ მიიღოთ უახლესი განახლებები!
📚 ეს სახელმძღვანელო შეიცავს უზარმაზარ ღირებულებას, 🌟ეს იშვიათი შესაძლებლობაა, არ გამოტოვოთ! ⏰⌛💨
გააზიარეთ და მოიწონეთ თუ მოგეწონათ!
თქვენი გაზიარება და მოწონებები ჩვენი უწყვეტი მოტივაციაა!