Çfarë do të thotë Markdown Si të përdorni shënimin e sintaksës/formatimit të Markdown?

MarkdownQe do te thote?

Si të përdorni shënimin e sintaksës/formatimit të Markdown?

Përmbledhje

Markdown është një gjuhë e lehtë shënjimi e krijuar nga John Gruber.

Ai i lejon njerëzit të "shkruajnë dokumente në format teksti të thjeshtë që është i lehtë për t'u lexuar dhe shkruar, dhe më pas i konvertojnë ato në dokumente të vlefshme XHTML (ose HTML).

Gjuha përfshin shumë nga veçoritë e shënimit të tekstit të thjeshtë që gjenden tashmë në e-mail.

John Gruber krijoi gjuhën Markdown në 2004, në bashkëpunim me Aaron Swartz në një pjesë të madhe në sintaksë.Qëllimi i gjuhës është të përdorë "një format teksti të thjeshtë që është i lehtë për t'u lexuar, i lehtë për t'u shkruar dhe opsionalisht i konvertuar në XHTML (ose HTML) të vlefshëm".

qëllimi

Qëllimi i Markdown është të jetë "i lehtë për t'u lexuar dhe i lehtë për t'u shkruar".

lexueshmëria, bëjeni gjithsesiMarketingu në internet, përvoja e përdoruesit është shumë e rëndësishme.

Një dokument i shkruar në Markdown duhet të jetë në gjendje të publikohet drejtpërdrejt në tekst të thjeshtë dhe nuk duhet të duket se përbëhet nga shumë etiketa ose direktiva formatimi.

Sintaksa Markdown ndikohet nga disa formate ekzistuese tekst-në-HTML, duke përfshirë Setext, atx, Textile, reStructuredText, Grutatext dhe EtText, por burimi më i madh i frymëzimit është formati i emailit me tekst të thjeshtë.

Shkurtimisht, sintaksa e Markdown është e gjitha e përbërë nga simbole, të cilat janë zgjedhur me kujdes dhe funksionet e tyre janë të qarta me një shikim.Për shembull: vendosni yje rreth tekstit për ta bërë atë të duket si *theksimi*.

Listat në Markdown duken si lista. Blockquotes në Markdown me të vërtetë duken si duke cituar një pjesë të tekstit, ashtu siç e keni parë në email.

E përputhshme me HTML

Qëllimi i gramatikës Markdown është të jetë një gjuhë shkrimi për ueb.

Markdown nuk ka për qëllim të zëvendësojë HTML, apo edhe të afrohet me të, ai ka shumë pak lloje sintakse dhe korrespondon vetëm me një nëngrup të vogël të shënjimit HTML. Markdown nuk u konceptua për t'i bërë më të lehtë dokumentet HTML për t'u shkruar.

Sipas mendimit tim, HTML është tashmë e lehtë për t'u shkruar. Ideja e Markdown është t'i bëjë dokumentet më të lehta për t'u lexuar, shkruar dhe ndryshuar sipas dëshirës. HTML është një format publikimi, Markdown është njëShkrimi i kopjimitformat e shkruar.Si e tillë, sintaksa e formatimit të Markdown mbulon vetëm atë që mundet teksti i thjeshtë.

Etiketat që nuk mbulohen nga Markdown mund të shkruhen në HTML direkt në dokumentPromovimi në uebkopje.Nuk ka nevojë ta shënoni këtë si HTML ose Markdown; thjesht shtoni shënimin direkt.

Vetëm disa elementë të bllokut HTML duhet të kufizohen - si p.sh <div>,<table>,<pre>,<p> dhe etiketat e tjera, ato duhet të ndahen nga zonat e tjera të përmbajtjes me rreshta bosh para dhe pas, dhe etiketat e tyre të hapjes dhe mbylljes nuk duhet të jenë të prera me skeda ose hapësira. Gjeneratori Markdown është mjaft i zgjuar për të mos shtuar etiketa të panevojshme të bllokut HTML <p> Etiketa.

Shembulli është si më poshtë, duke shtuar një tabelë HTML në skedarin Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Vini re se sintaksa e formatimit Markdown midis etiketave të bllokut HTML nuk do të përpunohet.Për shembull, nëse përdorni stilin Markdown brenda blloqeve HTML*强调*nuk do të ketë efekt.

Etiketat e seksionit HTML (inline) si p.sh <span>,<cite>,<del> Mund të përdoret lirisht në paragrafët, listat ose titujt Markdown.Sipas zakoneve personale, mund të përdorni edhe etiketat HTML për të formatuar pa përdorur formatin Markdown.Shembull: Nëse preferoni HTML <a> ose <img> etiketat, të cilat mund të përdoren drejtpërdrejt pa lidhjen ose sintaksën e etiketës së imazhit të ofruar nga Markdown.

Ndryshe nga etiketat e bllokut HTML, sintaksa Markdown është e vlefshme midis etiketave të seksionit HTML.

Konvertimi automatik i karaktereve speciale

Në skedarët HTML, ekzistojnë dy karaktere që kërkojnë trajtim të veçantë: < 和 & . < simbolet përdoren për etiketat e fillimit,& Simbolet përdoren për të shënuar entitetet HTML, nëse thjesht dëshironi të shfaqni prototipin e këtyre karaktereve, duhet të përdorni formën e entitetit, si p.sh. < 和 &.

& Personazhet janë veçanërisht torturues për shkrimtarët e dokumenteve në ueb, nëse do të shkruani "AT&T", ju duhet të shkruani"AT&T".ndërsa në URL & Personazhet gjithashtu konvertohen.Për shembull, ju dëshironi të lidheni me:

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

Ju duhet të shkruani konvertimin e URL-së si:

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

për t'u vendosur në etiketën e lidhjes href në prona.Eshtë e panevojshme të thuhet, kjo është e lehtë për t'u injoruar, dhe ndoshta numri më i madh i gabimeve të zbuluara nga vërtetimi i standardeve HTML.

Markdown ju lejon të shkruani karaktere natyrshëm dhe kujdeset për atë që duhet të konvertohet.nëse përdorni & Një karakter është pjesë e një entiteti të karaktereve HTML, ai lihet ashtu siç është, përndryshe konvertohet në &;.

Pra, nëse dëshironi të futni një simbol të së drejtës së autorit në dokument ©, ti mund te shkruash:

©

Markdown do ta lërë të paprekur.Dhe nëse shkruani:

AT&T

Markdown do ta konvertojë atë në:

AT&T

Një situatë e ngjashme ndodh edhe në < shënim, pasi Markdown lejon përputhshmërinë HTML, nëse vendosni < Simbolet përdoren si ndarës për etiketat HTML dhe Markdown nuk do të bëjë asnjë konvertim në to, por nëse shkruani:

4 < 5

Markdown do ta konvertojë atë në:

4 < 5

Sidoqoftë, duhet të theksohet se brenda fushës së kodit, pavarësisht nëse është inline ose bllok, < 和 & të dy simboletme sigurijanë konvertuar në entitete HTML, një veçori që ju lejon të shkruani lehtësisht kodin HTML në Markdown (në krahasim me HTML, ku vendosni të gjitha < 和 & Të gjitha konvertohen në entitete HTML, për të shkruar kodin HTML në skedarin HTML. )

element blloku

Paragrafët dhe ndërprerjet e rreshtave

Një paragraf Markdown përbëhet nga një ose më shumë rreshta teksti të njëpasnjëshëm, të paraprirë dhe të ndjekur nga më shumë se një rresht bosh (përkufizimi i një rreshti bosh është se ai duket të jetë bosh në ekran dhe konsiderohet të jetë një rresht bosh. Për shembull, , nëse një rresht përmban vetëm hapësira dhe skeda, rreshti do të trajtohet gjithashtu si një rresht bosh).Paragrafët normalë nuk duhet të jenë të prerë me hapësira ose skeda.

Shprehja "përbëhet nga një ose më shumë rreshta të njëpasnjëshëm teksti" në fakt nënkupton që Markdown lejon linjat e reja të detyruara (futja e linjave të reja) brenda paragrafëve, një veçori që është e ndryshme nga shumica e formateve të tjera tekst-në-HTML (duke përfshirë Llojin e lëvizshëm "Convert Line Breaks" " opsion), formate të tjera do të konvertojnë çdo ndërprerje rreshti në <br /> Etiketa.

nëse time të vërtetëDëshironi të mbështeteni te Markdown për të futur <br /> Për etiketat, shtypni dy ose më shumë hapësira në vendin e futjes dhe më pas shtypni Enter.

Në të vërtetë, duhet pak më shumë punë (hapësira shtesë) për të gjeneruar <br /> , por thjesht "çdo linjë e re konvertohet në <br />"Metoda nuk është e përshtatshme në Markdown, em në MarkdownaiBlloqet e stilit L dhe listat me shumë paragrafë jo vetëm që janë më të dobishme, por edhe më të lehta për t'u lexuar kur shkruani me ndërprerje rreshtash.

titull

Markdown mbështet dy sintaksa për titujt, të ngjashëm me Setext dhe të ngjashëm me atx.

Forma e ngjashme me Settekst është forma me vijën fundore, duke përdorur = (titulli më i lartë) dhe - (Titujt e rendit të dytë), për shembull:

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

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

çdo sasi = 和 - mund të jetë efektive.

Forma e ngjashme me Atx fut nga 1 deri në 6 në fillim të rreshtit # , që korrespondon me krerët 1 deri në 6, për shembull:

# 这是 H1

## 这是 H2

###### 这是 H6

Mund të "mbyllni" në mënyrë opsionale kokat e ngjashme me atx, kjo është thjesht për estetikë, nëse ndiheni rehat në këtë mënyrë, mund ta shtoni në fund të rreshtit #, ndërsa mbaresat e rreshtave # Numri nuk duhet të jetë i njëjtë me fillimin (numri i karaktereve paund në fillim të rreshtit përcakton rendin e titullit):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Blloqet e shënjimit Markdown përdoren të ngjashme me ato të përdorura në email > të citimeve.Nëse jeni njohur me kuotat në letrat e emailit, ju e dini se si të krijoni një kuotë blloku në një skedar Markdown, i cili do të duket sikur i thyeni vetë linjat, pastaj shtoni > :

> 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 gjithashtu ju lejon të jeni dembel dhe të shtoni vetëm rreshtin e parë të të gjithë paragrafit > :

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

Referencat e bllokut mund të ndërthuren (p.sh.: referencat brenda referencave) duke shtuar një numër të ndryshëm të > :

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

Sintaksa të tjera Markdown mund të përdoren gjithashtu brenda blloqeve të cituara, duke përfshirë titujt, listat, blloqet e kodeve, etj.:

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

Çdo redaktues i mirë i tekstit mund të krijojë lehtësisht citate në stilin e postës elektronike.Për shembull në BBEdit mund të zgjidhni tekstin dhe më pas të zgjidhni nga menyjarrit hierarkinë e citimeve.

listë

Markdown mbështet listat e renditura dhe të parregulluara.

Listat e pa renditura përdorin yll, shenja plus ose minus si shënues të listës:

*   Red
*   Green
*   Blue

Ekuivalente me:

+   Red
+   Green
+   Blue

Gjithashtu ekuivalente me:

-   Red
-   Green
-   Blue

Listat e renditura përdorin numra të ndjekur nga një pikë:

1.  Bird
2.  McHale
3.  Parish

Është e rëndësishme të theksohet se numrat që përdorni në etiketën e listës nuk ndikojnë në HTML-në e daljes. Shënimi HTML që rezulton për listën e mësipërme do të ishte:

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

Nëse shënimi i listës suaj është shkruar si:

1.  Bird
1.  McHale
1.  Parish

apo edhe:

3. Bird
1. McHale
8. Parish

Ju të dy do të merrni saktësisht të njëjtin rezultat HTML.Çështja është se ju mund t'i bëni numrat e listës në skedarin Markdown të ​​njëjtë me rezultatet e daljes, ose nëse jeni dembel, nuk keni nevojë të kujdeseni fare për korrektësinë e numrave.

Nëse përdorni shkrim dembel, rekomandohet të filloni me 1. për artikullin e parë, sepse Markdown mund të mbështesë atributin startues të listave të renditura në të ardhmen.

Etiketa e artikullit të listës zakonisht vendoset në skajin e majtë, por mund të jetë i futur, deri në 3 hapësira, dhe etiketa e artikullit duhet të pasohet nga të paktën një hapësirë ​​ose skedë.

Për ta bërë listën të duket më e bukur, mund t'i organizoni përmbajtjet me një indent fiks:

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

Por nëse jeni dembel, kjo është gjithashtu mirë:

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

Nëse artikujt e listës ndahen me rreshta bosh, Markdown do të përdorë përmbajtjen e artikujve kur nxjerr HTML. <p> Etiketat janë mbështjellë, për shembull:

*   Bird
*   Magic

do të konvertohet në:

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

Por kjo:

*   Bird

*   Magic

do të konvertohet në:

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

Artikujt e listës mund të përmbajnë paragrafë të shumtë dhe paragrafët nën secilin artikull duhet të jenë të dhëmbëzuara me 4 hapësira ose 1 skedë:

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.

Duket shumë më mirë nëse futni çdo rresht, natyrisht, përsëri, nëse jeni dembel, Markdown gjithashtu lejon:

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

Nëse dëshironi të vendosni një referencë brenda një artikulli të listës, atëherë > Duhet të futet në dhëmbëzim:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Nëse dëshironi të vendosni një bllok kodi, blloku duhet të futet në dhëmbëzimdy herë, që është 8 hapësira ose 2 skeda:

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

        <代码写在这>

Sigurisht, një listë artikujsh mund të krijohet aksidentalisht, diçka si kjo:

1986. What a great season.

Me fjalë të tjera, shfaqet në fillim të rreshtitnumër-periudha-bosh, për të shmangur këtë, mund të shtoni një vijë të prapme përpara periudhës.

1986\. What a great season.

bllok kodi

Shkrimi i lidhur me programin ose kodi burimor i gjuhës së etiketës zakonisht ka blloqe kodesh të shtypura tashmë. Zakonisht, ne nuk duam që këto blloqe të shtypen në mënyrën e skedarëve të paragrafëve të përgjithshëm, por t'i shfaqim ashtu siç janë. Markdown do të përdorë <pre> 和 <code> etiketat për të mbështjellë blloqet e kodit.

Ndërtimi i blloqeve të kodit në Markdown është po aq i thjeshtë sa futja në 4 hapësira ose 1 skedë, për shembull, shkruani sa vijon:

这是一个普通段落：

    这是一个代码区块。

Markdown do të konvertohet në:

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

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

Kjo dhëmbëzimi i rendit të parë për rresht (4 hapësira ose 1 skedë) hiqet, për shembull:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

do të konvertohet në:

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

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

Një bllok kodi vazhdon deri në rreshtin e paprerë (ose në fund të skedarit).

Brenda bllokut të kodit, & , < 和 > Ai do të konvertohet automatikisht në entitete HTML. Kjo metodë e bën shumë të lehtë për ju përdorimin e Markdown për të futur kodin burimor HTML për shembull, thjesht kopjoni dhe ngjitni atë, shtoni dhëmbëzimin dhe pjesën tjetër Markdown do ta trajtojë atë për ju, për shembull:

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

do të konvertohet në:

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

Në bllokun e kodit, sintaksa e përgjithshme Markdown nuk do të konvertohet, si p.sh. yjet janë vetëm yll, që do të thotë se mund të shkruani lehtësisht skedarë të lidhur me sintaksën Markdown në sintaksën Markdown.

ndarës

Ju mund të krijoni një ndarës me më shumë se tre yje, shenja minus, nënvizime në një rresht, asgjë tjetër në rresht.Ju gjithashtu mund të futni hapësira midis yjeve ose shenjave minus.Linjat e ndarjes mund të krijohen në secilën nga mënyrat e mëposhtme të shkrimit:

* * *

***

*****

- - -

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

elementi i seksionit

lidhja

Markdown mbështet dy forma të sintaksës së lidhjes: Në rradhë和Referencady forma.

Sido që të jetë, teksti i lidhjes shënohet me [kllapa katrore].

për të krijuar njëNë rradhëNëse dëshironi të shtoni tekstin e titullit të lidhjes, thjesht mbështillni tekstin e titullit me thonjëza të dyfishta pas URL-së, për shembull:

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

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

Do të prodhojë:

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

Nëse jeni duke u lidhur me burime në të njëjtin host, mund të përdorni shtigje relative:

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

ReferencaLidhja pasohet nga një tjetër kllapë katrore pas kllapave të tekstit të lidhjes dhe shenja e përdorur për të identifikuar lidhjen duhet të plotësohet në kllapin e dytë katror:

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

Mund të vendosni në mënyrë opsionale një hapësirë ​​midis dy kllapave katrore:

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

Më pas, kudo në skedar, mund të përcaktoni përmbajtjen e lidhjes së kësaj etikete:

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

Përmbajtja e lidhjes përcaktohet në formën:

• Kllapa katrore (mundësisht të paraprihen deri në tre hapësira për dhëmbëzimin) në të cilat futet teksti i lidhjes
• e ndjekur nga një dy pika
• e ndjekur nga një ose më shumë hapësira ose skeda
• URL-ja e lidhjes tjetër
• Ndiqni opsionalisht përmbajtjen e titullit, e cila mund të mbyllet në thonjëza të vetme, thonjëza të dyfishta ose kllapa

Përkufizimet e tre lidhjeve të mëposhtme janë të njëjta:

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

kujdes:Ekziston një problem i njohur ku Markdown.pl 1.0.1 injoron titujt e lidhjeve të mbyllura në thonjëza të vetme.

URL-të e lidhjeve mund të mbyllen gjithashtu në kllapa këndore:

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

Ju gjithashtu mund të vendosni atributin e titullit në rreshtin tjetër, ose të shtoni ndonjë dhëmbëzim, i cili do të duket më mirë nëse URL-ja është shumë e gjatë:

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

Përkufizimi i URL-së përdoret vetëm kur krijon lidhjen dhe nuk shfaqet drejtpërdrejt në skedar.

Etiketat e identifikimit të lidhjeve mund të përmbajnë shkronja, numra, hapësira të bardha dhe shenja pikësimi, por jonukËshtë sensitive, kështu që dy lidhjet e mëposhtme janë të njëjta:

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

Etiketa e lidhjes së nënkuptuarfunksioni ju lejon të mos specifikoni një etiketë lidhjeje. Në këtë rast, etiketa e lidhjes do të trajtohet si ekuivalente me tekstin e lidhjes. Për të përdorur një etiketë lidhjeje të nënkuptuar, thjesht shtoni një kllapa katrore bosh pas tekstit të lidhjes. Nëse dëshironi "Google " Duke u lidhur me google.com, mund të thjeshtoni në:

[Google][]

Pastaj përcaktoni përmbajtjen e lidhjes:

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

Meqenëse teksti i lidhjes mund të përmbajë hapësirë ​​të bardhë, ky shënim i thjeshtuar mund të përmbajë disa fjalë:

Visit [Daring Fireball][] for more information.

Pastaj vazhdoni të përcaktoni lidhjen:

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

Përkufizimi i lidhjes mund të vendoset kudo në skedar. Preferoj ta vendos direkt pas paragrafit ku shfaqet lidhja. Mund ta vendosni edhe në fund të skedarit, thjesht si një koment.

Këtu është një shembull i një lidhje referimi:

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"

Nëse e ndryshoni atë për të përdorur emrin e lidhjes për të shkruar:

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"

Dy mënyrat e mësipërme të shkrimit do të prodhojnë HTML-në e mëposhtme.

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

Më poshtë është një skedar Markdown me të njëjtën përmbajtje të shkruar në linjë, i ofruar për krahasim:

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

Në fakt, pika e lidhjeve të stilit të referencës nuk është se është më e lehtë për t'u shkruar, por se është më e lehtë për t'u lexuar. Krahasoni shembullin e mësipërm. Vetë artikulli i stilit të referencës ka vetëm 81 karaktere, por forma e brendshme do të rritet në 176 karaktere. , nëse është shkruar në format të pastër HTML, do të ketë 234 karaktere. Në formatin HTML, ka më shumë etiketa sesa tekst.

Duke përdorur lidhjet e stilit të referencës së Markdown, mund ta bëni dokumentin më shumë si rezultati përfundimtar i shfletuesit, duke ju lejuar të zhvendosni disa meta të dhëna të lidhura me shënimin jashtë tekstit të paragrafit dhe mund të shtoni lidhje pa e bërë ndjenjën e leximit të artikullit. ndërpres .

强调

Markdown përdor yjet (*) dhe fundi (_) si simbol për të shënuar një fjalë të nënvizuar, është * ose _ Fjalët e rrethuara konvertohen në <em> i rrethuar me etiketa, me dy * ose _Nëse mbështillet, do të shndërrohet në <strong>, p.sh.

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

do të shndërrohet në:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Ju mund të përdorni çfarëdo stili që ju pëlqen, i vetmi kufizim është se mund të përdorni simbolin për të hapur etiketën dhe simbolin për t'i dhënë fund.

Theksi gjithashtu mund të futet drejtpërdrejt në mes të tekstit:

un*frigging*believable

pornese e jotja * 和 _ Nëse ka hapësira të bardha në të dyja anët, ato trajtohen thjesht si simbole normale.

Për të futur yjet normale ose nënvizat drejtpërdrejt para dhe pas tekstit, mund të përdorni vija të prapme:

\*this text is surrounded by literal asterisks\*

Kodin

Nëse dëshironi të shënoni një pjesë të vogël të kodit të linjës, mund ta mbështillni atë në prapavijë (`), p.sh.

Use the `printf()` function.

Do të prodhojë:

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

Nëse dëshironi të futni prapambetje brenda një seksioni kodi, mund ta filloni dhe ta përfundoni seksionin e kodit me shumë prapambetje:

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

Kjo sintaksë prodhon:

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

Ju mund të vendosni një bosh në fillim dhe në fund të një seksioni kodi, një pas fillimit dhe një para fundit, kështu që mund të futni prapavijë në fillim të seksionit:

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

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

Do të prodhojë:

<p>A single backtick in a code span: <code>`</code></p>

<p>A backtick-delimited string in a code span: <code>`foo`</code></p>

Brenda seksionit të kodit,& dhe kllapa këndore都do të konvertohet automatikisht në entitete HTML, gjë që e bën të lehtë futjen e kodit burimor HTML, Markdown do të vendosë paragrafin e mëposhtëm:

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

te:

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

Ju gjithashtu mund të shkruani këtë:

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

Të prodhosh:

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

图片

Natyrisht, është e vështirë të hartosh një sintaksë "natyrore" për futjen e imazheve në një aplikacion vetëm me tekst.

Markdown përdor një sintaksë të ngjashme me lidhjet për të shënuar imazhet, dhe gjithashtu lejon dy stile: Në rradhë和Referenca.

Sintaksa e imazhit në linjë duket si:

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

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

Detajet janë si më poshtë:

• një pikëçuditëse !
• e ndjekur nga një kllapa katrore me tekst alt për imazhin
• Pastaj një kllapa normale, vendosni URL-në e figurës brenda dhe në fund mbështilleni atë në thonjëza dhe shtoni një tekst opsional 'titulli'.

Sintaksa e imazhit të referencës duket si kjo:

![Alt text][id]

"id" është emri i referencës së imazhit, i cili përcaktohet në të njëjtën mënyrë si referenca e lidhjes:

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

Deri më tani, Markdown nuk ka asnjë mënyrë për të specifikuar gjerësinë dhe lartësinë e imazhit, nëse keni nevojë, mund të përdorni normalin <img> Etiketa.

其它

lidhje automatike

Markdown mbështet përpunimin e URL-ve dhe kutive postare të postës elektronike në formën e lidhjeve automatike relativisht të shkurtra. Për sa kohë që ato janë të mbyllura në kllapa këndore, Markdown do ta konvertojë atë automatikisht në një lidhje.Teksti i lidhjes së URL-së së përgjithshme është i njëjtë me adresën e lidhjes, për shembull:

<http://example.com/>

Markdown do të konvertohet në:

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

Lidhja automatike e adresave të postës elektronike është gjithashtu e ngjashme, përveç se Markdown fillimisht do të kryejë një proces konvertimi kodimi, duke konvertuar karakteret e tekstit në entitete HTML heksadecimal. Ky format mund të mashtrojë disa robotë të këqij të mbledhjes së adresave të postës elektronike, të tilla si:

<[email protected]>

Markdown do të kthehet në:

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

Në shfletues, ky varg (në fakt <a href="mailto:[email protected]">[email protected]</a>) bëhet një lidhje e klikueshme "[email protected]".

(Edhe pse kjo qasje mund të mashtrojë shumë robotë, nuk mund t'i ndalojë të gjithë, por është më mirë se asgjë. Në çdo rast, hapja e kutisë tuaj postare përfundimisht do të tërheqë letra reklamuese.)

kthesë e prapme

Markdown mund të përdorë kthesa të pasme për të futur simbole që kanë kuptime të tjera në gramatikë, për shembull: nëse dëshironi të shtoni një yll pranë tekstit për theksim (por jo <em> etiketë), ju mund t'i paraprini yllit me një vijë të prapme:

\*literal asterisks\*

Markdown mbështet simbolet e mëposhtme të paraprira nga një vijë e prapme për të ndihmuar në futjen e simboleve të zakonshme:

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

Redaktori pa pagesë i Markdown

Platforma Windows

• MarkdownPad
• MarkPad

Platforma Mac

• Mou

redaktor në internet

• MPEditor

shtojca e shfletuesit

• Shtojca Markdown here

*** Nëse ka një redaktues më të mirë falas të Markdown për të rekomanduar, ju lutemi kushtojini vëmendje komenteveChen Weiliang,Faleminderit!