Məqalələr kataloqu
MarkdownNə deməkdir?
Markdown sintaksisi/format işarələməsindən necə istifadə etmək olar?
Baxış
Markdown John Gruber tərəfindən yaradılmış yüngül işarələmə dilidir.
O, insanlara "sənədləri oxumaq və yazmaq asan olan düz mətn formatında yazmağa və sonra onları etibarlı XHTML (və ya HTML) sənədlərinə çevirməyə" imkan verir.
Dil artıq e-poçtda tapılan düz mətn işarələməsinin bir çox xüsusiyyətlərini özündə birləşdirir.
John Gruber Markdown dilini 2004-cü ildə Aaron Swartz ilə birlikdə sintaksis üzrə böyük hissədə yaratdı.Dilin məqsədi "oxuması asan, yazması asan və isteğe bağlı olaraq etibarlı XHTML (və ya HTML)-yə çevrilən düz mətn formatından" istifadə etməkdir.
məqsəd
Markdown-un məqsədi "oxuması asan və yazması asan" olmaqdır.
oxunaqlılıq, hər halda bunu edin网络 营销, istifadəçi təcrübəsi çox vacibdir.
Markdown-da yazılmış fayl birbaşa düz mətndə dərc oluna bilməli və çoxlu teqlərdən və ya formatlaşdırma direktivlərindən ibarət görünməməlidir.
Markdown sintaksisi Setext, atx, Textile, reStructuredText, Grutatext və EtText daxil olmaqla bəzi mövcud mətndən HTML formatına təsir edir, lakin ən böyük ilham mənbəyi düz mətn e-poçt formatıdır.
Bir sözlə, Markdown-un sintaksisi diqqətlə seçilmiş və funksiyaları bir baxışda aydın olan simvollardan ibarətdir.Məsələn: mətnin *vurğu* kimi görünməsi üçün ətrafına ulduzlar qoyun.
Markdown-dakı siyahılar siyahılara bənzəyir. Markdown-da blok dırnaqlar həqiqətən e-poçtlarda gördüyünüz kimi mətn parçasından sitat gətirməyə bənzəyir.
HTML ilə uyğundur
Markdown qrammatikasının məqsədi internet üçün yazı dili olmaqdır.
Markdown HTML-ni əvəz etmək, hətta ona yaxınlaşmaq üçün nəzərdə tutulmayıb, o, çox az sintaksis növünə malikdir və HTML işarələməsinin yalnız kiçik alt dəstinə uyğun gəlir. Markdown HTML sənədlərinin yazılmasını asanlaşdırmaq üçün nəzərdə tutulmamışdır.
Fikrimcə, HTML yazmaq artıq asandır. Markdown ideyası sənədləri oxumağı, yazmağı və istədiyiniz kimi dəyişdirməyi asanlaşdırmaqdır. HTML nəşriyyat formatıdır, Markdown aKopiraytinqyazılı format.Beləliklə, Markdown-un formatlaşdırma sintaksisi yalnız düz mətnin nə edə biləcəyini əhatə edir.
Markdown ilə əhatə olunmayan teqlər HTML-də birbaşa sənəddə yazıla bilərVeb Təbliğatsurəti.Bunu HTML və ya Markdown kimi qeyd etməyə ehtiyac yoxdur; sadəcə olaraq işarələməni birbaşa əlavə edin.
Yalnız bəzi HTML blok elementləri məhdudlaşdırılmalıdır - məsələn <div>,<table>,<pre>,<p> və digər teqlərdən əvvəl və sonra boş sətirlərlə digər məzmun sahələrindən ayrılmalıdır və onların açılış və bağlanma teqləri tab və ya boşluqlarla girintili olmamalıdır. Markdown generatoru lazımsız HTML blok teqləri əlavə etməyəcək qədər ağıllıdır <p> etiket.
Məsələn, Markdown faylına HTML cədvəlinin əlavə edilməsi aşağıdakı kimidir:
这是一个普通段落。
<table>
<tr>
<td>Foo</td>
</tr>
</table>
这是另一个普通段落。
Qeyd edək ki, HTML blok teqləri arasında Markdown formatlama sintaksisi işlənməyəcək.Məsələn, HTML blokunun içərisində Markdown stilindən istifadə etsəniz*强调*heç bir təsiri olmayacaq.
HTML bölməsi (inline) kimi etiketlər <span>,<cite>,<del> Markdown paraqraflarında, siyahılarında və ya başlıqlarında sərbəst şəkildə istifadə edilə bilər.Şəxsi vərdişlərə görə, hətta Markdown formatından istifadə etmədən formatlaşdırmaq üçün HTML teqlərindən istifadə edə bilərsiniz.Misal: HTML-ə üstünlük verirsinizsə <a> Və ya <img> Markdown tərəfindən təmin edilən link və ya şəkil etiketi sintaksisi olmadan birbaşa istifadə edilə bilən teqlər.
HTML blok teqlərindən fərqli olaraq, Markdown sintaksisi HTML bölmə teqləri arasında etibarlıdır.
Xüsusi simvolların avtomatik çevrilməsi
HTML fayllarında xüsusi işləmə tələb edən iki simvol var: < 和 & . < simvollar başlanğıc etiketləri üçün istifadə olunur,& Simvollar HTML obyektlərini qeyd etmək üçün istifadə olunur, əgər sadəcə bu simvolların prototipini göstərmək istəyirsinizsə, obyekt formasından istifadə etməlisiniz, məsələn: < 和 &.
& Xarakterlər xüsusilə veb sənəd müəllifləri üçün əzab verir, əgər yazacaqsınızsa "AT&T", yazmalısınız"AT&T".URL-də olarkən & Simvollar da çevrilir.Məsələn, siz əlaqə yaratmaq istəyirsiniz:
http://images.google.com/images?num=30&q=larry+bird
URL çevrilməsini aşağıdakı kimi yazmalısınız:
http://images.google.com/images?num=30&q=larry+bird
link etiketinə yerləşdirilməlidir href xassələrində.Deməyə ehtiyac yoxdur ki, buna məhəl qoymamaq asandır və yəqin ki, HTML standartlarının təsdiqi ilə aşkar edilən ən çox səhvdir.
Markdown simvolları təbii şəkildə yazmağa imkan verir və nəyin çevrilməsi lazım olduğuna diqqət yetirir.istifadə etsəniz & Simvol HTML simvol obyektinin bir hissəsidir, olduğu kimi qalır, əks halda çevrilir &;.
Beləliklə, sənədə müəllif hüququ simvolu daxil etmək istəyirsinizsə ©, yaza bilərsiniz:
©
Markdown onu toxunulmaz qoyacaq.Və yazsanız:
AT&T
Markdown onu aşağıdakılara çevirəcək:
AT&T
Bənzər bir vəziyyət də baş verir < notation, çünki Markdown HTML uyğunluğu verir, əgər qoyursanız < Simvollar HTML teqləri üçün ayırıcı kimi istifadə olunur və Markdown onlar üzərində heç bir dönüşüm etməyəcək, ancaq yazsanız:
4 < 5
Markdown onu aşağıdakılara çevirəcək:
4 < 5
Bununla belə, qeyd etmək lazımdır ki, kod daxilində, istər daxili, istərsə də blok, < 和 & hər iki simvoləmin üçünHTML obyektlərinə çevrilir, bu xüsusiyyət sizə Markdown-da HTML kodunu asanlıqla yazmağa imkan verir (HTML-dən fərqli olaraq, burada bütün mətnləri yerləşdirirsiniz. < 和 & HTML faylına HTML kodu yazmaq üçün hamısı HTML obyektlərinə çevrilir. )
blok elementi
Paraqraflar və sətir sonları
Markdown paraqrafı bir və ya bir neçə ardıcıl mətn sətirindən ibarətdir, ondan əvvəl və ardınca birdən çox boş sətir (boş sətrin tərifi odur ki, o, ekranda boş görünür və boş sətir sayılır. Məsələn, , , sətirdə yalnız boşluqlar və nişanlar varsa, sətir də boş sətir kimi qəbul ediləcək).Normal abzaslarda boşluqlar və ya nişanlar qoyulmamalıdır.
"Bir və ya bir neçə ardıcıl mətn sətirindən ibarətdir" ifadəsi əslində Markdownun paraqraflar daxilində məcburi sətir kəsimlərinə (yeni sətirlərin daxil edilməsinə) icazə verdiyini nəzərdə tutur ki, bu xüsusiyyət əksər digər mətndən HTML formatına (o cümlədən, Daşınan Növ "Hətti çevirmə" daxil olmaqla) fərqlidir. Breaks" seçimi), digər formatlar hər sətir fasiləsini çevirəcək <br /> etiket.
Əgər sənhəqiqətənDaxil etmək üçün Markdown-a etibar etmək istəyirsiniz <br /> Etiketlər üçün daxiletmə yerində iki və ya daha çox boşluğa basın və sonra Enter düyməsini basın.
Həqiqətən, yaratmaq üçün bir az daha çox iş (əlavə boşluqlar) tələb olunur <br /> , lakin sadəcə olaraq "hər yeni sətirə çevrilir <br />“Metod Markdown-da uyğun deyil, Markdown-daaiL tipli blok dırnaqlar və çox paraqraflı siyahılar yalnız daha faydalı deyil, həm də sətir fasilələri ilə yazı yazarkən oxunması daha asandır.
Başlıq
Markdown başlıqlar üçün Setext və atx kimi iki sintaksisi dəstəkləyir.
Settext kimi forma, istifadə edərək, alt xətt olan formadır = (ən yüksək başlıq) və - (İkinci sıra başlıqları), məsələn:
This is an H1
=============
This is an H2
-------------
istənilən məbləğ = 和 - təsirli ola bilər.
Atx-ə bənzər forma xəttin əvvəlinə 1-dən 6-ya qədər əlavə edir # , 1-6 başlıqlarına uyğundur, məsələn:
# 这是 H1
## 这是 H2
###### 这是 H6
İstəyən atx kimi başlıqları "bağlaya" bilərsiniz, bu sırf estetika üçündür, əgər özünüzü bu şəkildə rahat hiss edirsinizsə, onu sətrin sonuna əlavə edə bilərsiniz. #, xətt bitərkən # Nömrə başlanğıcla eyni olmamalıdır (sətrin əvvəlindəki funt simvolların sayı başlığın sırasını müəyyən edir):
# 这是 H1 #
## 这是 H2 ##
### 这是 H3 ######
Blockquotes Blockquotes
Markdown işarələmə blok dırnaqları e-poçtda istifadə olunanlara bənzər istifadə olunur > sitatlardan.Əgər siz e-poçt məktublarındakı sitatlarla tanışsınızsa, siz Markdown faylında sətirləri özünüz qırdığınız kimi görünən blok sitat yaratmağı bilirsiniz, sonra əlavə edin > :
> 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 həmçinin tənbəl olmağa və bütün paraqrafın yalnız birinci sətrini əlavə etməyə imkan verir > :
> 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.
Blok arayışları fərqli sayda əlavə etməklə (məsələn: istinadlar daxilində istinadlar) yuvalana bilər > :
> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.
Digər Markdown sintaksisləri də sitat gətirilən bloklarda, o cümlədən başlıqlar, siyahılar, kod blokları və s. daxilində istifadə edilə bilər:
> ## 这是一个标题。
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
> 给出一些例子代码：
>
> return shell_exec("echo $input | $markdown_script");
İstənilən layiqli mətn redaktoru asanlıqla e-poçt üslubunda sitatlar yarada bilər.Məsələn, BBEdit-də mətni seçə və sonra menyudan seçə bilərsinizsitat iyerarxiyasını artırmaq.
Siyahı
Markdown sıralı və sıralanmamış siyahıları dəstəkləyir.
Sıralanmamış siyahılar siyahı markerləri kimi ulduz, üstəlik və ya mənfi işarələrdən istifadə edir:
* Red
* Green
* Blue
Bərabərdir:
+ Red
+ Green
+ Blue
Həmçinin ekvivalent:
- Red
- Green
- Blue
Sıralı siyahılar nömrələrdən sonra nöqtədən istifadə edir:
1. Bird
2. McHale
3. Parish
Qeyd etmək vacibdir ki, siyahı etiketində istifadə etdiyiniz nömrələr HTML çıxışına təsir etmir. Yuxarıdakı siyahı üçün nəticədə HTML işarələməsi belə olacaq:
<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>
Siyahınızın işarələməsi belə yazılıbsa:
1. Bird
1. McHale
1. Parish
və ya hətta:
3. Bird
1. McHale
8. Parish
Hər ikiniz eyni HTML çıxışını əldə edəcəksiniz.Məsələ burasındadır ki, siz Markdown faylındakı siyahı nömrələrini çıxış nəticələri ilə eyni edə bilərsiniz və ya tənbəllik edirsinizsə, rəqəmlərin düzgünlüyünə qətiyyən əhəmiyyət verməyə ehtiyac yoxdur.
Tənbəl yazıdan istifadə edirsinizsə, ilk element üçün 1. ilə başlamaq tövsiyə olunur, çünki Markdown gələcəkdə sifarişli siyahıların başlanğıc atributunu dəstəkləyə bilər.
Siyahı elementi teqi adətən ən solda yerləşdirilir, lakin o, 3 boşluğa qədər girintili ola bilər və element teqindən sonra ən azı bir boşluq və ya tab olmalıdır.
Siyahının daha gözəl görünməsi üçün məzmunu sabit abzas ilə təşkil edə bilərsiniz:
* 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.
Ancaq tənbəlsinizsə, bu da yaxşıdır:
* 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.
Siyahı elementləri boş sətirlərlə ayrılıbsa, Markdown HTML çıxararkən elementlərin məzmunundan istifadə edəcək. <p> Etiketlər bükülür, məsələn:
* Bird
* Magic
çevriləcək:
<ul>
<li>Bird</li>
<li>Magic</li>
</ul>
Amma bu:
* Bird
* Magic
çevriləcək:
<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>
Siyahı elementlərində bir neçə abzas ola bilər və hər bir elementin altındakı paraqraflar 4 boşluq və ya 1 tab ilə girintilənməlidir:
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.
Əgər hər bir sətir girinti qoysanız, daha yaxşı görünür, əlbəttə ki, yenə də tənbəlsinizsə, Markdown da imkan verir:
* 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.
Əgər siyahı elementinin içərisinə istinad qoymaq istəyirsinizsə, o zaman > Bu girinti lazımdır:
* A list item with a blockquote:
> This is a blockquote
> inside a list item.
Bir kod bloku qoymaq istəyirsinizsə, blok girintili olmalıdıriki dəfə, 8 boşluq və ya 2 tab:
* 一列表项包含一个列表区块：
<代码写在这>
Əlbəttə ki, elementlərin siyahısı təsadüfən yaradıla bilər, buna bənzər bir şey:
1986. What a great season.
Başqa sözlə, xəttin əvvəlində görünürədəd-dövr-boş, bunun qarşısını almaq üçün nöqtədən əvvəl tərs xətt əlavə edə bilərsiniz.
1986\. What a great season.
kod bloku
Proqramla əlaqəli yazı və ya etiket dilinin mənbə kodu adətən artıq yığılmış kod bloklarına malikdir. Adətən, biz bu blokların ümumi paraqraf faylları kimi yığılmasını istəmirik, lakin onları olduğu kimi göstərin. Markdown istifadə edəcək <pre> 和 <code> kod bloklarını bağlamaq üçün etiketlər.
Markdown-da kod bloklarının yaradılması 4 boşluq və ya 1 tab daxil etmək qədər sadədir. Məsələn, aşağıdakıları daxil edin:
这是一个普通段落：
这是一个代码区块。
Markdown aşağıdakılara çevriləcək:
<p>这是一个普通段落：</p>
<pre><code>这是一个代码区块。
</code></pre>
Hər sətir üçün bu birinci dərəcəli abzas (4 boşluq və ya 1 tab) silinir, məsələn:
Here is an example of AppleScript:
tell application "Foo"
beep
end tell
çevriləcək:
<p>Here is an example of AppleScript:</p>
<pre><code>tell application "Foo"
beep
end tell
</code></pre>
Kod bloku girintisiz sətirə (və ya faylın sonuna) qədər davam edir.
Kod blokunun içərisində, & , < 和 > O, avtomatik olaraq HTML obyektlərinə çevriləcək, bu, nümunə üçün HTML mənbə kodunu daxil etmək üçün Markdown-dan istifadə etməyi çox asanlaşdırır, sadəcə onu kopyalayıb yapışdırın, abzas əlavə edin və Markdown-un qalan hissəsi bunu sizin üçün idarə edəcək, misal üçün:
<div class="footer">
© 2004 Foo Corporation
</div>
çevriləcək:
<pre><code><div class="footer">
© 2004 Foo Corporation
</div>
</code></pre>
Kod blokunda ümumi Markdown sintaksisi çevrilməyəcək, məsələn ulduzlar sadəcə ulduzlardır, yəni siz Markdown sintaksisində Markdown sintaksisi ilə əlaqəli faylları asanlıqla yaza bilərsiniz.
bölücü
Xəttdə bölücü yaratmaq üçün üçdən çox ulduz, mənfi işarə, alt xətt istifadə edə bilərsiniz, sətirdə başqa heç nə yoxdur.Siz həmçinin ulduzlar və ya mənfi işarələr arasında boşluq qoya bilərsiniz.Ayırma xətləri aşağıdakı yazı üsullarının hər birində yaradıla bilər:
* * *
***
*****
- - -
---------------------------------------
bölmə elementi
link
Markdown link sintaksisinin iki formasını dəstəkləyir: Xətdə和İstinadiki forma.
İstənilən halda keçid mətni [kvadrat mötərizə] ilə qeyd olunur.
yaratmaq aXətdəƏgər linkin başlıq mətnini əlavə etmək istəyirsinizsə, sadəcə başlıq mətnini URL-dən sonra qoşa dırnaq işarəsi ilə sarın, məsələn:
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
İstehsal edəcək:
<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>
Eyni hostdakı resurslara keçid edirsinizsə, nisbi yollardan istifadə edə bilərsiniz:
See my [About](/about/) page for details.
İstinadLinkdən sonra keçid mətninin mötərizəsindən sonra başqa kvadrat mötərizə qoyulur və keçidi müəyyən etmək üçün istifadə olunan işarə ikinci kvadrat mötərizədə doldurulmalıdır:
This is [an example][id] reference-style link.
Siz həmçinin iki kvadrat mötərizə arasında boşluq qoya bilərsiniz:
This is [an example] [id] reference-style link.
Sonra faylın istənilən yerində bu teqin link məzmununu təyin edə bilərsiniz:
[id]: http://example.com/ "Optional Title Here"
Link məzmunu formada müəyyən edilir:
- Link mətninin daxil edildiyi kvadrat mötərizələr (istəyə görə abzas üçün üç boşluqdan əvvəl)
- ardınca kolon
- sonra bir və ya daha çox boşluq və ya nişanlar
- növbəti keçidin URL-i
- İstəyə görə tək dırnaq, qoşa dırnaq və ya mötərizədə daxil edilə bilən başlıq məzmununa əməl edin
Aşağıdakı üç əlaqənin tərifləri eynidir:
[foo]: http://example.com/ "Optional Title Here"
[foo]: http://example.com/ 'Optional Title Here'
[foo]: http://example.com/ (Optional Title Here)
xəbərdarlıq:Markdown.pl 1.0.1-in tək dırnaqlar içərisindəki link başlıqlarına məhəl qoymadığı məlum məsələ var.
Link URL-ləri bucaqlı mötərizədə də daxil edilə bilər:
[id]: <http://example.com/> "Optional Title Here"
Siz həmçinin başlıq atributunu növbəti sətirə yerləşdirə və ya URL çox uzun olarsa, daha yaxşı görünəcək bəzi abzas əlavə edə bilərsiniz:
[id]: http://example.com/longish/path/to/resource/here
"Optional Title Here"
URL tərifləri yalnız keçidlər yaradan zaman istifadə olunur və birbaşa faylda görünmür.
Link identifikasiya teqlərində hərflər, rəqəmlər, boşluqlar və durğu işarələri ola bilər, lakin bunlar yoxdurXeyrBu, hərflərə həssasdır, ona görə də aşağıdakı iki keçid eynidir:
[link text][a]
[link text][A]
Gizli keçid etiketixüsusiyyət sizə keçid teqini göstərməyi buraxmağa imkan verir. Bu halda, keçid teqi link mətninə ekvivalent kimi baxılacaq. Gizli keçid teqindən istifadə etmək üçün link mətnindən sonra boş kvadrat mötərizə əlavə etmək kifayətdir. Əgər istəyirsinizsə, "Google" " google.com-a keçid edərək, aşağıdakıları sadələşdirə bilərsiniz:
[Google][]
Sonra link məzmununu müəyyənləşdirin:
[Google]: http://google.com/
Link mətnində boşluq ola biləcəyi üçün bu sadələşdirilmiş işarələmə bir neçə sözdən ibarət ola bilər:
Visit [Daring Fireball][] for more information.
Sonra keçidi təyin etməyə davam edin:
[Daring Fireball]: http://daringfireball.net/
Linkin tərifi faylın istənilən yerinə yerləşdirilə bilər.Mən onu birbaşa keçidin göründüyü abzasdan sonra qoymağa üstünlük verirəm.Siz də şərh kimi faylın sonuna qoya bilərsiniz.
Budur bir istinad linki nümunəsi:
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"
Bunu yazmaq üçün keçid adını istifadə etmək üçün dəyişdirsəniz:
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"
Yuxarıdakı iki yazı üsulu aşağıdakı HTML-ni yaradacaq.
<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>
Aşağıda müqayisə üçün təqdim edilən eyni məzmunun inline yazılmış Markdown faylı verilmişdir:
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").
Əslində, istinad üslublu bağlantıların məqsədi yazmağın asan olması deyil, oxumağın daha asan olmasıdır.Yuxarıdakı nümunəni müqayisə edin.İstinad tipli məqalənin özü cəmi 81 simvoldan ibarətdir, lakin sətirli forma artacaq. 176 simvol. , təmiz HTML formatında yazılsa, 234 simvol olacaq. HTML formatında mətndən daha çox teq var.
Markdown-un istinad üslublu keçidlərindən istifadə sənədi brauzerin yekun nəticəsi kimi daha çox bənzədir, bəzi işarələmə ilə əlaqəli metadataları paraqraf mətnindən kənara köçürməyə imkan verir və siz məqaləni oxumadan keçidlər əlavə edə bilərsiniz.
强调
Markdown ulduz işarələrindən istifadə edir (*) və nəticə (_) işarəsi kimi altı çizili sözü qeyd etmək olar * Və ya _ Ətrafdakı sözlər çevrilir <em> etiketlərlə əhatə olunmuş, iki ilə * Və ya _Əgər bükülüdürsə, çevriləcək <strong>, Məsələn:
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
çevriləcək:
<em>single asterisks</em>
<em>single underscores</em>
<strong>double asterisks</strong>
<strong>double underscores</strong>
İstədiyiniz üslubdan istifadə edə bilərsiniz, yeganə məhdudiyyət etiketi açmaq üçün simvoldan və onu bitirmək üçün simvoldan istifadə edə bilərsiniz.
Vurğu birbaşa mətnin ortasına da daxil edilə bilər:
un*frigging*believable
AmmaƏgər sənin * 和 _ Hər iki tərəfdə boşluq varsa, onlar sadəcə normal simvollar kimi qəbul edilir.
Mətndən əvvəl və sonra birbaşa ulduz və ya alt xətt əlavə etmək üçün əks kəsiklərdən istifadə edə bilərsiniz:
\*this text is surrounded by literal asterisks\*
Kod
Kiçik bir xətt kodunu qeyd etmək istəyirsinizsə, onu arxa işarələrə sarıya bilərsiniz (`), məsələn:
Use the `printf()` function.
İstehsal edəcək:
<p>Use the <code>printf()</code> function.</p>
Kod bölməsinin içərisinə arxa işarələr daxil etmək istəyirsinizsə, kod bölməsini bir neçə geri işarə ilə başlaya və bitirə bilərsiniz:
``There is a literal backtick (`) here.``
Bu sintaksis istehsal edir:
<p><code>There is a literal backtick (`) here.</code></p>
Kod bölməsinin əvvəlində və sonunda, əvvəlindən sonra və sonundan əvvəl boşluq qoya bilərsiniz, beləliklə bölmənin əvvəlinə arxa işarələr əlavə edə bilərsiniz:
A single backtick in a code span: `` ` ``
A backtick-delimited string in a code span: `` `foo` ``
İstehsal edəcək:
<p>A single backtick in a code span: <code>`</code></p>
<p>A backtick-delimited string in a code span: <code>`foo`</code></p>
Kod bölməsində,& və bucaq mötərizələri都HTML mənbə kodunu daxil etməyi asanlaşdıran avtomatik olaraq HTML obyektlərinə çevriləcək, Markdown aşağıdakı paraqrafı qoyacaq:
Please don't use any `<blink>` tags.
üçün:
<p>Please don't use any <code><blink></code> tags.</p>
Bunu da yaza bilərsiniz:
`—` is the decimal-encoded equivalent of `—`.
İstehsal:
<p><code>—</code> is the decimal-encoded
equivalent of <code>—</code>.</p>
图片
Aydındır ki, yalnız mətn tətbiqinə şəkillərin daxil edilməsi üçün "təbii" sintaksisi tərtib etmək çətindir.
Markdown şəkilləri işarələmək üçün keçidlərə bənzər sintaksisdən istifadə edir və həmçinin iki üsluba imkan verir: Xətdə和İstinad.
Daxili şəkil sintaksisi belə görünür:
Təfərrüatlar aşağıdakılardır:
- nida işarəsi
! - ardınca şəkil üçün alternativ mətn olan kvadrat mötərizə
- Bunun ardınca şəklin URL-i olan normal mötərizələr və nəhayət, dırnaq içərisində isteğe bağlı "başlıq" mətni gəlir.
İstinad şəkli sintaksisi belə görünür:
![Alt text][id]
"id" link istinadı ilə eyni şəkildə müəyyən edilən şəkil istinadının adıdır:
[id]: url/to/image "Optional title attribute"
İndiyə qədər Markdown-da təsvirin enini və hündürlüyünü təyin etmək üçün heç bir yol yoxdur, ehtiyacınız varsa, normal istifadə edə bilərsiniz. <img> etiket.
其它
avtomatik keçid
Markdown nisbətən qısa avtomatik keçidlər şəklində URL-lərin və e-poçt poçt qutularının işlənməsini dəstəkləyir.Onlar bucaqlı mötərizədə olduğu müddətcə Markdown onu avtomatik olaraq linkə çevirəcək.Ümumi URL-in keçid mətni keçid ünvanı ilə eynidir, məsələn:
<http://example.com/>
Markdown aşağıdakılara çevriləcək:
<a href="http://example.com/">http://example.com/</a>
E-poçt ünvanlarının avtomatik əlaqələndirilməsi də çox oxşardır, ancaq Markdown əvvəlcə mətn simvollarını onaltılıq HTML obyektlərinə çevirərək kodlaşdırma çevirmə prosesini həyata keçirəcək. Bu format bəzi pis e-poçt ünvanlarının toplanması robotlarını aldada bilər, məsələn:
<[email protected]>
Markdown çevriləcək:
<a href="mailto:addre
[email protected]
m">address@exa
mple.com</a>
Brauzerdə bu sətir (əslində <a href="mailto:[email protected]">[email protected]</a>) tıklana bilən "[email protected]" linkinə çevrilir.
(Bu yanaşma bir çox robotu aldada bilsə də, onların hamısını dayandıra bilməz, lakin heç nədən yaxşıdır. Hər halda, poçt qutunuzu açmaq sonda reklam məktublarını cəlb edəcək.)
əks kəsik
Markdown qrammatikaya başqa mənaları olan simvolları daxil etmək üçün əks kəsiklərdən istifadə edə bilər, məsələn: vurğu üçün mətnin yanına ulduz işarəsi əlavə etmək istəyirsinizsə (lakin yox <em> teq), ulduzdan əvvəl tərs xətt çəkə bilərsiniz:
\*literal asterisks\*
Markdown ümumi simvolların daxil edilməsinə kömək etmək üçün qarşısında tərs kəsik işarəsi olan aşağıdakı simvolları dəstəkləyir:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号Markdown pulsuz redaktor
Windows platforması
Mac platforması
onlayn redaktor
brauzer plagini
*** Tövsiyə etmək üçün daha yaxşı pulsuz Markdown redaktoru varsa, rəyə diqqət yetirinChen Weiliang,Çox sağ ol!
Hope Chen Weiliang Blogu ( https://www.chenweiliang.com/ ) paylaşdı "Markdown nə deməkdir? Markdown sintaksisi/format işarələməsindən necə istifadə etmək olar? , sənə kömək etmək.
Bu məqalənin linkini paylaşmağa xoş gəlmisiniz:https://www.chenweiliang.com/cwl-482.html
Ən son yenilikləri əldə etmək üçün Chen Weiliang bloqunun Telegram kanalına xoş gəlmisiniz!
📚 Bu təlimatda böyük dəyər var, 🌟Bu nadir fürsətdir, qaçırmayın! ⏰⌛💨
Bəyəndinizsə paylaşın və bəyənin!
Paylaşımlarınız və bəyənmələriniz davamlı motivasiyamızdır!