Markdown nimani anglatadi? Markdown sintaksisi/formatlash belgilaridan qanday foydalanish kerak?

MarkdownNimani anglatadi?

Markdown sintaksisi/formatlash belgilaridan qanday foydalanish kerak?

Ko'proq

Markdown - bu Jon Gruber tomonidan yaratilgan engil belgilash tili.

Bu odamlarga "hujjatlarni o'qish va yozish oson bo'lgan oddiy matn formatida yozish va keyin ularni haqiqiy XHTML (yoki HTML) hujjatlariga aylantirish" imkonini beradi.

Til elektron pochtada allaqachon topilgan oddiy matn belgilashning ko'pgina xususiyatlarini o'z ichiga oladi.

Jon Gruber Markdown tilini 2004 yilda sintaksis bo'yicha Aaron Svarts bilan hamkorlikda yaratgan.Tilning maqsadi "o'qish oson, yozish oson va ixtiyoriy ravishda haqiqiy XHTML (yoki HTML) ga o'zgartiriladigan oddiy matn formatidan" foydalanishdir.

maqsad

Markdownning maqsadi "oson o'qish va yozish oson" bo'lishdir.

o'qish qobiliyati, baribir buni qilingInternet-marketing, foydalanuvchi tajribasi juda muhim.

Markdown-da yozilgan hujjat to'g'ridan-to'g'ri oddiy matnda nashr etilishi kerak va ko'plab teglar yoki formatlash ko'rsatmalaridan iborat bo'lmasligi kerak.

Markdown sintaksisi ba'zi mavjud matndan HTMLga formatlari, jumladan Setext, atx, Textile, reStructuredText, Grutatext va EtText tomonidan ta'sirlanadi, ammo eng katta ilhom manbai oddiy matnli elektron pochta formatidir.

Muxtasar qilib aytganda, Markdown sintaksisi diqqat bilan tanlangan belgilardan iborat bo'lib, ularning vazifalari bir qarashda aniq ko'rinadi.Masalan: matn atrofida yulduzcha qo'ying, u *ta'kid* kabi ko'rinadi.

Markdown-dagi ro'yxatlar ro'yxatlarga o'xshaydi. Markdown-dagi blok qo'shtirnoqlar haqiqatan ham elektron pochta xabarlarida ko'rganingizdek, matndan iqtibos keltirganga o'xshaydi.

HTML bilan mos keladi

Markdown grammatikasining maqsadi internet uchun yozish tili bo'lishdir.

Markdown HTML o'rnini bosish yoki hatto unga yaqinlashish uchun mo'ljallanmagan, u juda kam sintaktik o'zgarishlarga ega va faqat HTML belgilashning kichik to'plamiga mos keladi. Markdown HTML hujjatlarini yozishni osonlashtirish uchun ishlab chiqilmagan.

Menimcha, HTML yozish allaqachon oson. Markdown g'oyasi hujjatlarni o'qish, yozish va xohlagancha o'zgartirishni osonlashtirishdir. HTML nashriyot formati, Markdown aKopirayterlikyozma format.Shunday qilib, Markdown formatlash sintaksisi faqat oddiy matnni qamrab oladi.

Markdown tomonidan qoplanmagan teglar to'g'ridan-to'g'ri hujjatda HTMLda yozilishi mumkinVeb-tashviqotnusxa ko'chirish.Buni HTML yoki Markdown sifatida belgilashning hojati yo'q; shunchaki belgilashni to'g'ridan-to'g'ri qo'shing.

Faqat ba'zi HTML blok elementlarini cheklash mumkin - masalan <div>,<table>,<pre>,<p> va boshqa teglar, ular boshqa kontent maydonlaridan oldin va keyin boʻsh satrlar bilan ajratilgan boʻlishi kerak va ularning ochilish va yopish teglari yorliqlar yoki boʻshliqlar bilan chegaralanmasligi kerak. Markdown generatori keraksiz HTML blok teglarini qo'shmaslik uchun etarlicha aqlli <p> Yorliq.

Markdown fayliga HTML jadvalini qo'shish misoli quyidagicha:

这是一个普通段落。

<table>
    <tr>
        <td>Foo</td>
    </tr>
</table>

这是另一个普通段落。

HTML blok teglari orasidagi Markdown formatlash sintaksisi qayta ishlanmasligini unutmang.Misol uchun, agar siz HTML blokida Markdown uslubidan foydalansangiz*强调*ta'siri bo'lmaydi.

kabi HTML bo'limi (inline) teglari <span>,<cite>,<del> Markdown paragraflari, ro'yxatlari yoki sarlavhalarida erkin foydalanish mumkin.Shaxsiy odatlarga ko'ra, Markdown formatidan foydalanmasdan formatlash uchun hatto HTML teglaridan ham foydalanishingiz mumkin.Misol: Agar siz HTMLni afzal ko'rsangiz <a> Yoki <img> teglar, ular Markdown tomonidan taqdim etilgan havola yoki rasm yorlig'i sintaksisisiz bevosita ishlatilishi mumkin.

HTML blok teglaridan farqli o'laroq, Markdown sintaksisi HTML bo'lim teglari orasida amal qiladi.

Maxsus belgilarni avtomatik aylantirish

HTML fayllarida maxsus ishlov berishni talab qiluvchi ikkita belgi mavjud: < 和 & . < belgilar boshlang'ich teglar uchun ishlatiladi,& Belgilar HTML ob'ektlarini belgilash uchun ishlatiladi, agar siz ushbu belgilarning prototipini ko'rsatishni istasangiz, ob'ekt shaklidan foydalanishingiz kerak, masalan < 和 &.

& Agar siz yozmoqchi bo'lsangiz, qahramonlar ayniqsa veb-hujjat mualliflarini qiynamoqda.AT&T", siz yozishingiz kerak"AT&T".URL manzilida & Belgilar ham aylantiriladi.Masalan, siz havola qilmoqchisiz:

http://images.google.com/images?num=30&q=larry+bird

URL konvertatsiyasini quyidagicha yozishingiz kerak:

http://images.google.com/images?num=30&q=larry+bird

havola tegiga joylashtirilishi kerak href xususiyatlarida.Aytishga hojat yo'q, buni e'tiborsiz qoldirish oson va, ehtimol, HTML standartlarini tekshirishda aniqlangan xatolarning eng ko'p soni.

Markdown belgilarni tabiiy ravishda yozishga imkon beradi va nima o'zgartirilishi kerakligi haqida g'amxo'rlik qiladi.foydalansangiz & Belgi HTML belgilar ob'ektining bir qismi bo'lib, u xuddi shunday qoldiriladi, aks holda u o'zgartiriladi &;.

Shunday qilib, agar siz hujjatga mualliflik huquqi belgisini kiritmoqchi bo'lsangiz ©, yozishingiz mumkin:

©

Markdown uni tegmasdan qoldiradi.Va agar siz yozsangiz:

AT&T

Markdown uni quyidagiga aylantiradi:

AT&T

Shunga o'xshash vaziyatda ham sodir bo'ladi < notation, Markdown HTML mosligini beradi beri, Agar qo'yish < Belgilar HTML teglari uchun ajratuvchi sifatida ishlatiladi va Markdown ularda hech qanday konvertatsiya qilmaydi, lekin agar siz yozsangiz:

4 < 5

Markdown uni quyidagiga aylantiradi:

4 < 5

Ammo shuni ta'kidlash kerakki, kod doirasida, u inline yoki blokli bo'ladimi, < 和 & ikkala belgialbattaHTML ob'ektlariga aylantiriladi, bu sizga Markdown-da HTML kodini osongina yozish imkonini beruvchi xususiyatdir (HTML-dan farqli o'laroq, bu erda siz hamma narsani joylashtirasiz. < 和 & HTML faylida HTML kodini yozish uchun barchasi HTML ob'ektlariga aylantiriladi. )

blok elementi

Paragraflar va qatorlar

Markdown paragrafi bir yoki bir nechta ketma-ket matn qatorlaridan iborat bo‘lib, oldidan va undan keyin bir nechta bo‘sh satrlardan iborat bo‘ladi (bo‘sh satrning ta’rifi shundan iboratki, u displeyda bo‘sh ko‘rinadi va bo‘sh qator hisoblanadi. Masalan, , agar satrda faqat bo'shliqlar va yorliqlar bo'lsa, satr ham bo'sh qator sifatida ko'rib chiqiladi).Oddiy paragraflar bo'sh joy yoki yorliqlar bilan chegaralanmasligi kerak.

"Bir yoki bir nechta ketma-ket matn satrlaridan iborat" iborasi aslida Markdown xatboshilar ichida majburiy yangi qatorlarni (yangi qatorlarni qo'shish) ruxsat berishini anglatadi, bu xususiyat boshqa matndan HTML formatga (jumladan, "Ko'chma turdagi" "Qattiq uzilishlarni aylantirish" dan farq qiladi. " opsiyasi), boshqa formatlar har bir satr tanaffusiga o'zgartiradi <br /> Yorliq.

Agar Sizhaqiqatdan hamKiritish uchun Markdown-ga tayanmoqchimisiz <br /> Yorliqlar uchun kiritish joyida ikki yoki undan ortiq bo'sh joyni bosing va Enter tugmasini bosing.

Darhaqiqat, ishlab chiqarish uchun biroz ko'proq ish (qo'shimcha joylar) talab etiladi <br /> , lekin oddiygina "har bir yangi qatorga aylantiriladi <br />“Usul Markdown-da, Markdown-da mos emasaiL uslubidagi blok-tirnoqlar va ko'p paragrafli ro'yxatlar nafaqat foydaliroq, balki qatorlar oralig'i bilan matn terishda ham o'qishni osonlashtiradi.

Sarlavha

Markdown sarlavhalar uchun ikkita sintaksisni qo'llab-quvvatlaydi: Setext-ga o'xshash va atx-ga o'xshash.

Settext-ga o'xshash shakl - bu pastki chiziqdan foydalangan holda shakl = (eng yuqori unvon) va - (Ikkinchi tartib sarlavhalari), masalan:

This is an H1
=============

This is an H2
-------------

har qanday miqdor = 和 - samarali bo'lishi mumkin.

Atx-ga o'xshash shakl satr boshiga 1 dan 6 gacha qo'shadi # , 1 dan 6 gacha sarlavhalarga mos keladi, masalan:

# 这是 H1

## 这是 H2

###### 这是 H6

Siz ixtiyoriy ravishda atx-ga o'xshash sarlavhalarni "yopishingiz" mumkin, bu faqat estetika uchun, agar siz o'zingizni qulay his qilsangiz, uni satr oxiriga qo'shishingiz mumkin #, chiziq tugaydigan paytda # Raqam boshi bilan bir xil bo'lishi shart emas (satr boshidagi funt belgilar soni sarlavha tartibini belgilaydi):

# 这是 H1 #

## 这是 H2 ##

### 这是 H3 ######

Blockquotes Blokquotes

Markdown belgilash blok tirnoqlari elektron pochtada ishlatiladiganlarga o'xshash ishlatiladi > iqtiboslar.Agar siz hali ham elektron pochta xatlaridagi tirnoq bilan tanish bo'lsangiz, siz Markdown faylida qanday qilib blokli iqtibos yaratishni bilasiz. > :

> 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 shuningdek, dangasa bo'lishga va butun paragrafning faqat birinchi qatorini qo'shishga imkon beradi > :

> 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 havolalarini boshqa raqam qoʻshish orqali joylashtirish mumkin (masalan: havolalar ichidagi havolalar). > :

> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

Boshqa Markdown sintaksislari kotirovka qilingan bloklarda, jumladan, sarlavhalar, ro'yxatlar, kod bloklari va boshqalarda ham ishlatilishi mumkin:

> ## 这是一个标题。
> 
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。
> 
> 给出一些例子代码：
> 
>     return shell_exec("echo $input | $markdown_script");

Har qanday munosib matn muharriri osongina elektron pochta uslubidagi iqtiboslarni yaratishi mumkin.Masalan, BBEdit-da siz matnni tanlashingiz va keyin menyudan tanlashingiz mumkiniqtibos ierarxiyasini oshirish.

Ro‘yxat

Markdown tartiblangan va tartiblanmagan ro'yxatlarni qo'llab-quvvatlaydi.

Tartibsiz roʻyxatlar roʻyxat belgilari sifatida yulduzcha, ortiqcha yoki minus belgilaridan foydalanadi:

*   Red
*   Green
*   Blue

Ekvivalent:

+   Red
+   Green
+   Blue

Shuningdek, ekvivalent:

-   Red
-   Green
-   Blue

Tartiblangan roʻyxatlar raqamlardan soʻng nuqtadan foydalanadi:

1.  Bird
2.  McHale
3.  Parish

Shuni ta'kidlash kerakki, ro'yxat tegida ishlatadigan raqamlar HTML chiqishiga ta'sir qilmaydi. Yuqoridagi ro'yxat uchun natijada HTML belgisi quyidagicha bo'ladi:

<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>

Agar ro'yxat belgilashingiz quyidagicha yozilgan bo'lsa:

1.  Bird
1.  McHale
1.  Parish

yoki hatto:

3. Bird
1. McHale
8. Parish

Ikkalangiz ham bir xil HTML chiqishini olasiz.Gap shundaki, siz Markdown faylidagi roʻyxat raqamlarini chiqish natijalari bilan bir xil qilib qoʻyishingiz mumkin, yoki dangasa boʻlsangiz, raqamlarning toʻgʻriligiga umuman eʼtibor qaratishingiz shart emas.

Agar siz dangasa yozishdan foydalansangiz, birinchi element uchun 1. dan boshlash tavsiya etiladi, chunki Markdown kelajakda tartiblangan roʻyxatlarning start atributini qoʻllab-quvvatlashi mumkin.

Roʻyxat elementi yorligʻi odatda eng chap tomonga joylashtiriladi, lekin u chekinishi mumkin, 3 ta boʻsh joy va element tegidan keyin kamida bitta boʻsh joy yoki yorliq boʻlishi kerak.

Ro'yxatni yanada chiroyli qilish uchun siz tarkibni sobit chekinish bilan tartibga solishingiz mumkin:

*   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.

Agar siz dangasa bo'lsangiz, bu ham yaxshi:

*   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.

Ro'yxat elementlari bo'sh satrlar bilan ajratilgan bo'lsa, Markdown HTMLni chiqarishda element tarkibidan foydalanadi. <p> Yorliqlar o'ralgan, masalan:

*   Bird
*   Magic

ga aylantiriladi:

<ul>
<li>Bird</li>
<li>Magic</li>
</ul>

Lekin bu:

*   Bird

*   Magic

ga aylantiriladi:

<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>

Ro'yxat elementlari bir nechta paragrafdan iborat bo'lishi mumkin va har bir element ostidagi paragraflar 4 bo'sh joy yoki 1 yorliq bilan chekinishi kerak:

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.

Agar siz har bir qatorni cheklab qo'ysangiz, bu juda yaxshi ko'rinadi, albatta, agar siz dangasa bo'lsangiz, Markdown ham quyidagilarga imkon beradi:

*   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.

Agar siz ro'yxat elementiga havola qo'ymoqchi bo'lsangiz, unda > Uni cheklash kerak:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Agar siz kod blokini qo'ymoqchi bo'lsangiz, blok chekinishi kerakikki marta, bu 8 bo'shliq yoki 2 yorliq:

*   一列表项包含一个列表区块：

        <代码写在这>

Albatta, elementlar ro'yxati tasodifan yaratilishi mumkin, masalan:

1986. What a great season.

Boshqacha qilib aytganda, u satrning boshida paydo bo'ladiraqam-davr-bo'sh, buning oldini olish uchun nuqtadan oldin teskari chiziq qo'shishingiz mumkin.

1986\. What a great season.

kod bloki

Dastur bilan bog'liq yozish yoki teg tilining manba kodida odatda terish kod bloklari mavjud. Odatda, biz bu bloklarni umumiy paragraf fayllari tarzida yozishni xohlamaymiz, lekin ularni qanday bo'lsa, shunday qilib ko'rsatish. Markdown funksiyasidan foydalanadi. <pre> 和 <code> kod bloklarini o'rash uchun teglar.

Markdown-da kod bloklarini yaratish 4 ta bo'sh joy yoki 1 yorliqni cheklash kabi oddiy. Masalan, quyidagilarni kiriting:

这是一个普通段落：

    这是一个代码区块。

Markdown quyidagilarga aylanadi:

<p>这是一个普通段落：</p>

<pre><code>这是一个代码区块。
</code></pre>

Har bir satr uchun birinchi tartibli chekinish (4 bo'sh joy yoki 1 yorliq) olib tashlanadi, masalan:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

ga aylantiriladi:

<p>Here is an example of AppleScript:</p>

<pre><code>tell application "Foo"
    beep
end tell
</code></pre>

Kod bloki cheklanmagan satrgacha (yoki fayl oxirigacha) davom etadi.

Kod blokining ichida, & , < 和 > U avtomatik ravishda HTML ob'ektlariga aylantiriladi. Bu usul sizga misol uchun HTML manba kodini kiritish uchun Markdown-dan foydalanishni juda osonlashtiradi, shunchaki uni nusxalash va joylashtirish, chekinish qo'shish, qolgan qismi Markdown buni siz uchun hal qiladi. misol:

    <div class="footer">
        © 2004 Foo Corporation
    </div>

ga aylantiriladi:

<pre><code><div class="footer">
    &copy; 2004 Foo Corporation
</div>
</code></pre>

Kod blokida umumiy Markdown sintaksisi o'zgartirilmaydi, masalan, yulduzchalar shunchaki yulduzcha, ya'ni Markdown sintaksisi bilan bog'liq fayllarni Markdown sintaksisida osongina yozishingiz mumkin.

ajratuvchi

Siz chiziqda uchtadan ortiq yulduzcha, minus belgilar, pastki chiziq bilan ajratuvchi yaratishingiz mumkin, chiziqda boshqa hech narsa yo'q.Bundan tashqari, yulduzcha yoki minus belgilar orasiga bo'sh joy qo'yishingiz mumkin.Ajratish satrlari quyidagi yozish usullarining har birida yaratilishi mumkin:

* * *

***

*****

- - -

---------------------------------------

bo'lim elementi

havola

Markdown havola sintaksisining ikkita shaklini qo'llab-quvvatlaydi: Mos ravishda和Malumotikki shakl.

Qanday bo'lmasin, havola matni [kvadrat qavs] bilan belgilanadi.

yaratish aMos ravishdaAgar siz havolaning sarlavha matnini qo'shmoqchi bo'lsangiz, URL manzilidan keyin sarlavha matnini qo'sh tirnoq bilan o'rang, masalan:

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

Ishlab chiqaradi:

<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>

Agar siz bir xil xostdagi resurslarga ulansangiz, nisbiy yo'llardan foydalanishingiz mumkin:

See my [About](/about/) page for details.

MalumotHavoladan keyin havola matni qavsdan keyin boshqa kvadrat qavs qo'yiladi va havolani aniqlash uchun ishlatiladigan belgi ikkinchi kvadrat qavs ichiga to'ldirilishi kerak:

This is [an example][id] reference-style link.

Bundan tashqari, ixtiyoriy ravishda ikkita kvadrat qavs orasiga bo'sh joy qo'yishingiz mumkin:

This is [an example] [id] reference-style link.

Keyin faylning istalgan joyida ushbu tegning havola mazmunini belgilashingiz mumkin:

[id]: http://example.com/  "Optional Title Here"

Havola tarkibi quyidagi shaklda aniqlanadi:

• Havola matni kiritiladigan kvadrat qavslar (ixtiyoriy ravishda chekinish uchun uchta boʻsh joy qoʻyiladi)
• keyin yo'g'on ichak
• keyin bir yoki bir nechta bo'shliqlar yoki yorliqlar
• keyingi havolaning URL manzili
• Ixtiyoriy ravishda bitta tirnoq, qo'sh tirnoq yoki qavs ichiga olinishi mumkin bo'lgan sarlavha mazmuniga amal qiling

Quyidagi uchta havolaning ta'riflari bir xil:

[foo]: http://example.com/  "Optional Title Here"
[foo]: http://example.com/  'Optional Title Here'
[foo]: http://example.com/  (Optional Title Here)

ehtiyotkorlik:Markdown.pl 1.0.1 bitta qo'shtirnoq ichiga olingan havola sarlavhalarini e'tiborsiz qoldiradigan muammo bor.

Havola URL manzillari burchakli qavslar ichiga ham kiritilishi mumkin:

[id]: <http://example.com/>  "Optional Title Here"

Shuningdek, sarlavha atributini keyingi qatorga qoʻyishingiz yoki URL manzili juda uzun boʻlsa, yaxshi koʻrinadigan chekinish qoʻshishingiz mumkin:

[id]: http://example.com/longish/path/to/resource/here
    "Optional Title Here"

URL ta'rifi faqat havolani yaratishda ishlatiladi va to'g'ridan-to'g'ri faylda ko'rinmaydi.

Havola identifikatsiya teglari harflar, raqamlar, bo'shliqlar va tinish belgilaridan iborat bo'lishi mumkin, lekin bunday emasYo'qU katta-kichik harflarga sezgir, shuning uchun quyidagi ikkita havola bir xil:

[link text][a]
[link text][A]

Yashirin havola tegifunksiya havola tegini ko‘rsatmaslikka imkon beradi. Bu holda havola yorlig‘i havola matniga ekvivalent sifatida qaraladi. Yashirin havola tegidan foydalanish uchun havola matnidan keyin bo‘sh kvadrat qavs qo‘shing. Agar xohlasangiz, “Google” " google.com ga ulanish orqali siz quyidagilarni soddalashtirishingiz mumkin:

[Google][]

Keyin havola tarkibini aniqlang:

[Google]: http://google.com/

Havola matnida bo'sh joy bo'lishi mumkinligi sababli, bu soddalashtirilgan belgi bir nechta so'zlardan iborat bo'lishi mumkin:

Visit [Daring Fireball][] for more information.

Keyin havolani aniqlashga o'ting:

[Daring Fireball]: http://daringfireball.net/

Havolaning ta'rifi faylning istalgan joyiga joylashtirilishi mumkin.Men uni havola paydo bo'lgan paragrafdan keyin to'g'ridan-to'g'ri qo'yishni afzal ko'raman.Shuningdek, uni xuddi sharh kabi faylning oxiriga qo'yishingiz mumkin.

Mana havola havolasiga misol:

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"

Agar siz havola nomini yozish uchun uni o'zgartirsangiz:

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"

Yuqoridagi ikkita yozish usuli quyidagi HTMLni ishlab chiqaradi.

<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>

Quyida taqqoslash uchun taqdim etilgan bir xil tarkibning inline yozilgan Markdown fayli keltirilgan:

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").

Haqiqatan ham, havola uslubidagi havolalarning maqsadi yozishni osonlashtirishida emas, balki o'qishni osonlashtirishidadir.Yuqoridagi misolni solishtiring.Ma'lumotnoma uslubidagi maqolaning o'zi bor-yo'g'i 81 belgidan iborat, lekin inline shakl ga ko'payadi. 176 belgi. , agar u sof HTML formatida yozilsa, 234 belgi bo'ladi.HTML formatida teglar matndan ko'ra ko'proq bo'ladi.

Markdown-ning havola uslubidagi havolalaridan foydalanib, siz hujjatni brauzerning yakuniy natijasiga o'xshatib qo'yishingiz mumkin, bu sizga belgilash bilan bog'liq metama'lumotlarni paragraf matnidan tashqariga ko'chirish imkonini beradi va maqolani o'qish hissini yaratmasdan havolalar qo'shishingiz mumkin. interrupt .

Ta'kidlash

Markdown yulduzchalardan foydalanadi (*) va pastki chiziq (_) tagiga chizilgan so‘zni belgilash uchun belgi sifatida, hisoblanadi * Yoki _ Atrofdagi so'zlar ga aylantiriladi <em> teglar bilan o'ralgan, ikkitasi bilan * Yoki _Agar u o'ralgan bo'lsa, u aylanadi <strong>,Masalan:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

aylanadi:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Siz o'zingizga yoqqan uslubdan foydalanishingiz mumkin, yagona cheklov shundaki, tegni qaysi belgi bilan tugatmoqchi bo'lsangiz, ochishingiz mumkin.

Urg'u to'g'ridan-to'g'ri matn o'rtasiga ham kiritilishi mumkin:

un*frigging*believable

lekinagar sizning * 和 _ Agar ikkala tomonda bo'sh joy bo'lsa, ular oddiy belgilar sifatida qabul qilinadi.

To'g'ridan-to'g'ri matndan oldin va keyin oddiy yulduzcha yoki pastki chiziq qo'yish uchun siz teskari chiziqdan foydalanishingiz mumkin:

\*this text is surrounded by literal asterisks\*

Kod

Agar siz ichki kodning kichik qismini belgilamoqchi bo'lsangiz, uni teskari belgilarga o'rashingiz mumkin (`), Masalan:

Use the `printf()` function.

Ishlab chiqaradi:

<p>Use the <code>printf()</code> function.</p>

Agar siz kod bo'limiga teskari belgilar qo'yishni istasangiz, kod bo'limini bir nechta orqa belgilar bilan boshlashingiz va tugatishingiz mumkin:

``There is a literal backtick (`) here.``

Ushbu sintaksis ishlab chiqaradi:

<p><code>There is a literal backtick (`) here.</code></p>

Kod bo'limining boshiga va oxiriga, boshidan keyin va oxiridan oldin bo'sh joy qo'yishingiz mumkin, shuning uchun bo'limning boshiga teskari belgilar qo'yishingiz mumkin:

A single backtick in a code span: `` ` ``

A backtick-delimited string in a code span: `` `foo` ``

Ishlab chiqaradi:

<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 bo'limi ichida,& va burchakli qavslar都HTML manba kodini kiritishni osonlashtiradigan HTML ob'ektlariga avtomatik ravishda aylantiriladi, Markdown quyidagi paragrafni qo'yadi:

Please don't use any `<blink>` tags.

kimga:

<p>Please don't use any <code><blink></code> tags.</p>

Buni ham yozishingiz mumkin:

`—` is the decimal-encoded equivalent of `—`.

Ishlab chiqarish uchun:

<p><code>&#8212;</code> is the decimal-encoded
equivalent of <code>&mdash;</code>.</p>

Rasmlar

Shubhasiz, faqat matnli ilovaga tasvirlar kiritish uchun "tabiiy" sintaksisni loyihalash qiyin.

Markdown rasmlarni belgilash uchun havolalarga o'xshash sintaksisdan foydalanadi va ikkita uslubga ruxsat beradi: Mos ravishda和Malumot.

Inline rasm sintaksisi quyidagicha ko'rinadi:

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

Tafsilotlar quyidagicha:

• undov belgisi !
• tasvir uchun muqobil matnli kvadrat qavs
• Undan keyin rasmning URL manzili bilan oddiy qavslar va nihoyat tirnoq ichiga olingan ixtiyoriy “sarlavha” matni keladi.

Malumot tasviri sintaksisi quyidagicha ko'rinadi:

![Alt text][id]

"id" - bu havola havolasi bilan bir xil tarzda aniqlangan rasm havolasining nomi:

[id]: url/to/image  "Optional title attribute"

Hozircha Markdown-da tasvirning kengligi va balandligini belgilashning imkoni yo'q, agar kerak bo'lsa, odatdagidan foydalanishingiz mumkin. <img> Yorliq.

Qīm

avtomatik havola

Markdown nisbatan qisqa avtomatik havolalar ko'rinishidagi URL va elektron pochta qutilarini qayta ishlashni qo'llab-quvvatlaydi. Agar ular burchakli qavslar ichida bo'lsa, Markdown uni avtomatik ravishda havolaga aylantiradi.Umumiy URLning havola matni havola manzili bilan bir xil, masalan:

<http://example.com/>

Markdown quyidagiga aylantiriladi:

<a href="http://example.com/">http://example.com/</a>

Elektron pochta manzillarini avtomatik bog‘lash ham shunga o‘xshash, faqat Markdown birinchi navbatda matn belgilarini o‘n oltilik HTML obyektlariga aylantirib, kodlash konvertatsiya jarayonini amalga oshiradi.Bu format ba’zi yomon elektron pochta manzillarini yig‘ish robotlarini aldashi mumkin, masalan:

<[email protected]>

Markdown quyidagilarga aylanadi:

<a href="mailto:addre
[email protected]
m">address@exa
mple.com</a>

Brauzerda bu qator (aslida <a href="mailto:[email protected]">[email protected]</a>) bosiladigan "[email protected]" havolasiga aylanadi.

(Bu yondashuv ko'plab robotlarni aldashi mumkin bo'lsa-da, ularning hammasini to'xtata olmaydi, lekin bu hech narsadan yaxshiroqdir. Har qanday holatda, pochta qutingizni ochish oxir-oqibat reklama xatlarini jalb qiladi.)

teskari chiziq

Markdown grammatikaga boshqa ma'noga ega bo'lgan belgilarni kiritish uchun teskari qiyshiq chiziqdan foydalanishi mumkin, masalan: ta'kidlash uchun matn yoniga yulduzcha qo'shmoqchi bo'lsangiz (lekin emas) <em> teg), yulduzcha oldidan teskari qiyshiq chiziq qo'yishingiz mumkin:

\*literal asterisks\*

Markdown umumiy belgilarni kiritishga yordam berish uchun oldidan teskari chiziq bilan kelgan quyidagi belgilarni qo'llab-quvvatlaydi:

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

Markdown bepul muharriri

Windows platformasi

• MarkdownPad
• MarkPad

Mac platformasi

• yumshoq

onlayn muharriri

• MPEditor

brauzer plagini

• Markdown bu yerda plagin

*** Tavsiya qilish uchun yaxshiroq bepul Markdown muharriri bo'lsa, fikr-mulohazalarga e'tibor beringChen Veyliang, rahmat!