Հոդվածների տեղեկատու
MarkdownԻնչ է նշանակում?
Ինչպե՞ս օգտագործել Markdown շարահյուսությունը/ձևաչափման նշումը:
Ակնարկ
Markdown-ը թեթև նշագրման լեզու է, որը ստեղծվել է Ջոն Գրուբերի կողմից:
Այն թույլ է տալիս մարդկանց «գրել փաստաթղթեր պարզ տեքստի ձևաչափով, որը հեշտ է կարդալ և գրել, այնուհետև դրանք վերածել վավեր XHTML (կամ HTML) փաստաթղթերի»:
Լեզուն ներառում է պարզ տեքստի նշագրման բազմաթիվ առանձնահատկություններ, որոնք արդեն հայտնաբերվել են էլ. փոստում:
Ջոն Գրուբերը ստեղծեց Markdown լեզուն 2004 թվականին՝ համագործակցելով Ահարոն Սվարցի հետ, մեծ մասամբ շարահյուսության վրա:Լեզվի նպատակն է օգտագործել «հասարակ տեքստի ձևաչափ, որը հեշտ է կարդալ, հեշտ է գրել և ընտրովի վերածվում է վավեր XHTML (կամ HTML)»:
նպատակը
Markdown-ի նպատակն է լինել «հեշտ ընթերցվող և հեշտ գրվող»:
ընթեռնելիություն, ամեն դեպքում արեք դա网络 营销, օգտագործողի փորձը շատ կարևոր է:
Markdown-ով գրված փաստաթուղթը պետք է կարողանա ուղղակիորեն հրապարակվել պարզ տեքստով և չպետք է կազմված լինի բազմաթիվ թեգերից կամ ձևաչափման հրահանգներից:
Markdown շարահյուսության վրա ազդում են որոշ գոյություն ունեցող տեքստի HTML ձևաչափեր, այդ թվում՝ Setext, atx, Textile, reStructuredText, Grutatext և EtText, բայց ոգեշնչման ամենամեծ աղբյուրը պարզ տեքստի էլփոստի ձևաչափն է:
Մի խոսքով, Markdown-ի շարահյուսությունը կազմված է խորհրդանիշներից, որոնք խնամքով ընտրված են, և դրանց գործառույթները պարզ են մի հայացքից:Օրինակ՝ տեքստի շուրջ աստղանիշներ դրեք, որպեսզի այն նմանվի *ընդգծված*:
Ցուցակները Markdown-ում նման են ցուցակներին: Blockquotes 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> պիտակ
Օրինակը հետևյալն է՝ Markdown ֆայլում HTML աղյուսակ ավելացնելով.
这是一个普通段落。
<table>
<tr>
<td>Foo</td>
</tr>
</table>
这是另一个普通段落。
Նկատի ունեցեք, որ Markdown ձևաչափման շարահյուսությունը HTML բլոկի թեգերի միջև չի մշակվի:Օրինակ, եթե դուք օգտագործում եք Markdown ոճը HTML բլոկների ներսում*强调*ազդեցություն չի ունենա.
HTML հատվածի (ներկառուցված) պիտակներ, ինչպիսիք են <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 նիշերի էության մաս է, այն մնում է այնպես, ինչպես կա, հակառակ դեպքում այն փոխարկվում է &;.
Այսպիսով, եթե ցանկանում եք փաստաթղթում տեղադրել հեղինակային իրավունքի նշան ©, կարող եք գրել.
©
Markdown-ը կթողնի այն անձեռնմխելի:Իսկ եթե գրես.
AT&T
Markdown-ը այն կվերածի հետևյալի.
AT&T
Նմանատիպ իրավիճակ նույնպես տեղի է ունենում < նշում, քանի որ Markdown-ը թույլ է տալիս HTML-ի համատեղելիություն, եթե տեղադրեք < Նշանները օգտագործվում են որպես HTML թեգերի սահմանազատիչներ, և Markdown-ը դրանց վրա փոխակերպումներ չի անի, բայց եթե դուք գրեք.
4 < 5
Markdown-ը այն կվերածի հետևյալի.
4 < 5
Այնուամենայնիվ, հարկ է նշել, որ կոդի շրջանակում, լինի դա ներկառուցված, թե արգելափակված, < 和 & երկու խորհրդանիշներըիհարկեփոխակերպվում են HTML սուբյեկտների, մի հատկություն, որը թույլ է տալիս հեշտությամբ գրել HTML կոդը Markdown-ում (ի տարբերություն HTML-ի, որտեղ դուք դնում եք բոլոր < 和 & Բոլորը փոխակերպվում են HTML սուբյեկտների՝ HTML ֆայլում HTML կոդ գրելու համար: )
արգելափակման տարր
Պարբերություններ և տողերի ընդմիջումներ
Markdown պարբերությունը կազմված է տեքստի մեկ կամ մի քանի հաջորդական տողերից, որոնց նախորդում և հաջորդում է մեկից ավելի դատարկ տող (դատարկ տողի սահմանումն այն է, որ այն ցուցադրվում է դատարկ և համարվում է դատարկ տող: Օրինակ, եթե տողը պարունակում է միայն բացատներ և ներդիրներ, տողը նույնպես կդիտարկվի որպես դատարկ տող):Սովորական պարբերությունները չպետք է կտրվեն բացատներով կամ ներդիրներով:
«Բաղկացած է տեքստի մեկ կամ մի քանի հաջորդական տողերից» արտահայտությունը իրականում ենթադրում է, որ Markdown-ը թույլ է տալիս հարկադիր նոր տողեր (նոր տողերի տեղադրում) պարբերություններում, մի հատկություն, որը տարբերվում է տեքստի HTML ձևաչափերից (ներառյալ շարժական տեսակը «Փոխակերպել տողերի ընդմիջումները»: « տարբերակ), այլ ձևաչափեր կվերափոխեն յուրաքանչյուր տողի ընդմիջում <br /> պիտակ
Եթե դուիսկապեսՏեղադրելու համար ցանկանում եք ապավինել Markdown-ին <br /> Պիտակների համար սեղմեք երկու կամ ավելի բացատներ տեղադրման վայրում, այնուհետև սեղմեք Enter:
Իսկապես, մի քիչ ավելի շատ աշխատանք է պահանջվում (լրացուցիչ բացատներ) առաջացնելու համար <br /> , բայց պարզապես «յուրաքանչյուր նոր տող փոխարկվում է <br />«Մեթոդը Markdown-ում հարմար չէ, em Markdown-ումaiL ոճի բլոկի չակերտները և բազմապարբերական ցուցակները ոչ միայն ավելի օգտակար են, այլև ավելի հեշտ են կարդալ տողերի ընդմիջումներով շարադրելիս:
Վերնագիր
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.-ով առաջին կետի համար, քանի որ Markdown-ը կարող է ապագայում աջակցել պատվիրված ցուցակների սկզբնական հատկանիշին։
Ցանկի տարրերի պիտակը սովորաբար տեղադրվում է ձախ կողմում, բայց այն կարող է ներքևվել մինչև 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-ն աջակցում է կապի շարահյուսության երկու ձևերի. Inline和Տեղեկանքերկու ձև.
Ամեն դեպքում, հղման տեքստը նշվում է [քառակուսի փակագծերով]:
ստեղծել աInlineԵթե ցանկանում եք ավելացնել հղման վերնագրի տեքստը, պարզապես վերնագրի տեքստը փաթաթեք 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-ի հղման ոճի հղումները՝ դուք կարող եք փաստաթուղթն ավելի նմանեցնել բրաուզերի վերջնական արդյունքին, ինչը թույլ կտա ձեզ տեղափոխել որոշ նշագրման հետ կապված մետատվյալներ պարբերության տեքստից դուրս, և կարող եք հղումներ ավելացնել՝ առանց հոդվածի ընթերցանության զգացողություն հաղորդելու: ընդհատեք: .
强调
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-ը օգտագործում է շարահյուսություն, որը նման է հղումներին՝ պատկերները նշելու համար, ինչպես նաև թույլ է տալիս երկու ոճ. Inline和Տեղեկանք.
Ներկառուցված պատկերի շարահյուսությունը նման է.
Մանրամասները հետևյալն են.
- բացականչական նշան
! - որին հաջորդում են պատկերի այլընտրանքային տեքստով քառակուսի փակագծեր
- Այնուհետև սովորական փակագիծ դրեք նկարի 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]>
Markdown-ը կվերածվի.
<a href="mailto:addre
[email protected]
m">address@exa
mple.com</a>
Բրաուզերում այս տողը (իրականում <a href="mailto:[email protected]">[email protected]</a>) դառնում է սեղմվող «[email protected]» հղում:
(Չնայած այս մոտեցումը կարող է խաբել շատ ռոբոտների, այն չի կարող կանգնեցնել նրանց բոլորին, բայց դա ավելի լավ է, քան ոչինչ: Ամեն դեպքում, բացելով ձեր փոստարկղը, ի վերջո, կգրավի գովազդային նամակներ):
հետշեղ
Markdown-ը կարող է օգտագործել հակադարձ տողեր՝ քերականության մեջ այլ նշանակություն ունեցող խորհրդանիշներ տեղադրելու համար, օրինակ՝ եթե ցանկանում եք տեքստի կողքին աստղանիշ ավելացնել՝ շեշտադրման համար (բայց ոչ <em> պիտակ), դուք կարող եք աստղանիշին նախորդել հետշեղով.
\*literal asterisks\*
Markdown-ն աջակցում է հետևյալ սիմվոլներին, որոնց նախորդում է հետշեղ, որը կօգնի ներդնել ընդհանուր նշաններ.
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号Markdown անվճար խմբագիր
Windows հարթակ
Mac հարթակ
առցանց խմբագիր
բրաուզերի պլագին
*** Եթե կա ավելի լավ անվճար Markdown խմբագիր առաջարկելու համար, խնդրում ենք ուշադրություն դարձնել արձագանքներինՉեն Վայլյան, Շնորհակալություն
Հույս Chen Weiliang բլոգ ( https://www.chenweiliang.com/ ) կիսվել է «Ի՞նչ է նշանակում Մարկդաուն: Ինչպե՞ս օգտագործել Markdown շարահյուսությունը/ձևաչափման նշումը: , քեզ օգնելու համար.
Բարի գալուստ՝ կիսելու այս հոդվածի հղումը.https://www.chenweiliang.com/cwl-482.html
Բարի գալուստ Chen Weiliang-ի բլոգի Telegram ալիք՝ վերջին թարմացումները ստանալու համար:
📚 Այս ուղեցույցը պարունակում է հսկայական արժեք, 🌟Սա հազվագյուտ հնարավորություն է, բաց մի՛ թողեք այն։ ⏰⌛💨
Տարածեք և հավանեք, եթե հավանեցիք:
Ձեր տարածումը և հավանումները մեր շարունակական շարժառիթն են: