Menene Markdown ke nufi? Yadda ake amfani da Markdown syntax/markup markup?

YankewaMe ake nufi?

Yadda ake amfani da Markdown syntax/tsara alama?

Bayani

Markdown harshe ne mara nauyi wanda John Gruber ya kirkira.

Yana ba mutane damar "rubutun takardu a tsarin rubutu na fili mai sauƙin karantawa da rubutawa, sannan su maida su cikin takaddun XHTML (ko HTML) masu inganci".

Harshen ya ƙunshi yawancin fasalulluka na alamar rubutu a sarari wanda aka riga aka samu a cikin imel.

John Gruber ya ƙirƙiri yaren Markdown a cikin 2004, tare da haɗin gwiwar Aaron Swartz a babban sashi akan haɗin gwiwa.Manufar harshen shine a yi amfani da "tsarin rubutu a sarari wanda yake da sauƙin karantawa, mai sauƙin rubutu, da zaɓin canzawa zuwa ingantaccen XHTML (ko HTML)".

manufa

Manufar Markdown shine ya zama "mai sauƙin karantawa da sauƙin rubutu".

karantawa, yi shi duk da hakaTallan Intanet, ƙwarewar mai amfani yana da mahimmanci.

Fayil da aka rubuta a Markdown yakamata a iya buga shi kai tsaye a cikin rubutu mara kyau, kuma bai kamata ya bayyana ya ƙunshi alamomi da yawa ko umarnin tsarawa ba.

Rubutun rubutu-zuwa-HTML na da tasiri akan Markdown syntax, gami da Setext, atx, Textile, reStructuredText, Grutatext, da EtText, amma babban tushen wahayi shine tsarin imel na rubutu a sarari.

A takaice dai, tsarin tsarin Markdown duk ya ƙunshi alamomi, waɗanda aka zaɓa a hankali kuma ayyukansu a sarari suke a sarari.Misali: sanya alamar alama a kusa da rubutu don yin kama da * girmamawa*.

Lissafi a cikin Markdown yayi kama da, da kyau, jeri. Blockquotes a Markdown yana kama da faɗin guntun rubutu, kamar yadda kuka gani a imel.

Mai jituwa da HTML

Manufar nahawun Markdown shine ya zama yaren rubutu don yanar gizo.

Markdown ba yana nufin maye gurbin HTML ba, ko ma ya zo kusa da shi, yana da ɗan ƙaramin magana kuma yayi daidai da ƙaramin yanki na alamar HTML. Ba a yi tunanin Markdown ba don sauƙaƙe takaddun HTML don rubutawa.

A ra'ayi na, HTML ya riga ya kasance da sauƙin rubutawa. Manufar Markdown shine don sauƙaƙe takardu don karantawa, rubutawa, da canza yadda ake so. HTML tsarin bugawa ne, Markdown shineRubutun rubuturubutaccen tsari.Don haka, tsarin tsarin Markdown ya ƙunshi abin da keɓaɓɓen rubutu zai iya.

Tags waɗanda Markdown bai rufe su ba ana iya rubuta su cikin HTML kai tsaye a cikin takaddarCi gaban Yanar Gizokwafi.Babu buƙatar yiwa wannan alama azaman HTML ko Markdown; kawai ƙara alamar kai tsaye.

Wasu abubuwan toshe HTML kawai za a takura su - kamar <div>,<table>,<pre>,<p> da sauran alamun, dole ne a raba su da sauran wuraren abun ciki tare da layukan da ba komai a ciki kafin da kuma bayansu, kuma ba za a iya shigar da alamun buɗewa da rufe su da shafuka ko sarari ba. Generator Markdown yana da wayo sosai don kada ya ƙara alamun toshe HTML mara amfani <p> Lakabi

Misali shine kamar haka, ƙara tebur HTML zuwa fayil ɗin Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Lura cewa tsarin tsarin Markdown tsakanin alamun toshe HTML ba za a sarrafa shi ba.Misali, idan kuna amfani da salon Markdown a cikin toshe HTML*强调*ba zai yi tasiri ba.

Sashen HTML (layi) tags kamar <span>,<cite>,<del> Ana iya amfani da shi kyauta a cikin sakin layi na Markdown, jeri ko kanun labarai.Dangane da halaye na sirri, zaku iya amfani da alamun HTML don tsarawa ba tare da amfani da tsarin Markdown ba.Misali: Idan kun fi son HTML <a> 或 <img> tags, waɗanda za a iya amfani da su kai tsaye ba tare da hanyar haɗin yanar gizo ko alamar alamar hoton da Markdown ya bayar ba.

Ba kamar tsakanin alamomin toshe HTML ba, Tsarin Markdown yana aiki tsakanin alamun sashin HTML.

Juyawa ta atomatik na haruffa na musamman

A cikin fayilolin HTML, akwai haruffa guda biyu waɗanda ke buƙatar kulawa ta musamman: < kuma & . < Ana amfani da alamomi don fara tags,& Ana amfani da alamomi don yiwa abubuwan HTML alama, idan kawai kuna son nuna samfurin waɗannan haruffa, dole ne kuyi amfani da sigar mahaɗan, kamar < kuma &.

& Haruffa suna azabtarwa musamman ga marubutan daftarin yanar gizo, idan za ku rubuta "AT&T", dole ne ka rubuta"AT&T".yayin cikin URL & Hakanan ana canza haruffa.Misali kuna son haɗawa zuwa:

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

Dole ne ku rubuta canjin URL kamar:

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

da za a sanya a cikin mahada tag href a cikin Properties.Ba lallai ba ne a faɗi, wannan abu ne mai sauƙi a yi watsi da shi, kuma mai yiwuwa mafi girman adadin kurakurai da aka gano ta ingantaccen matsayin HTML.

Markdown yana ba ku damar rubuta haruffa ta halitta, kuma yana kula da abin da ake buƙatar canzawa.idan kuna amfani & Hali wani bangare ne na mahallin halayen HTML, an bar shi kamar yadda yake, in ba haka ba an canza shi zuwa &;.

Don haka idan kuna son saka alamar haƙƙin mallaka a cikin takaddar ©, za ku iya rubuta:

©

Markdown zai bar shi ba a taɓa shi ba.Kuma idan ka rubuta:

AT&T

Markdown zai canza shi zuwa:

AT&T

Irin wannan yanayin kuma yana faruwa a ciki < sanarwa, tunda Markdown yana ba da damar dacewa da HTML, idan kun sanya < Ana amfani da alamomi azaman masu iyakance ga alamun HTML, kuma Markdown ba zai yi wani canji akan su ba, amma idan kun rubuta:

4 < 5

Markdown zai canza shi zuwa:

4 < 5

Duk da haka, ya kamata a lura da cewa a cikin ikon yinsa, ko yana cikin layi ko toshe. < kuma & duka alamomintabbasAna canza su zuwa abubuwan HTML, fasalin da ke ba ku damar rubuta lambar HTML cikin sauƙi a cikin Markdown (saɓanin HTML, inda kuka sanya duk abubuwan. < kuma & Dukkansu an canza su zuwa abubuwan HTML, don rubuta lambar HTML a cikin fayil ɗin HTML. )

toshe kashi

Sakin layi da karya layi

Sakin layi na Markdown ya ƙunshi layi ɗaya ko fiye a jere na rubutu, gabaɗaya da kuma biyo bayan layi fiye da ɗaya (ma'anar layin da ba komai shine cewa ya bayyana babu komai akan nunin kuma ana ɗaukarsa a matsayin mara komai. Misali, , idan layi ya ƙunshi sarari da shafuka kawai, layin kuma za a yi la'akari da shi azaman layin da ba komai).Bai kamata a sanya sakin layi na yau da kullun tare da sarari ko shafuka ba.

Kalmomin "ya ƙunshi layi ɗaya ko fiye a jere na rubutu" a zahiri yana nuna cewa Markdown yana ba da damar karya layin tilastawa (sakar sabbin layukan) a cikin sakin layi, fasalin da ya bambanta da yawancin tsarin rubutu zuwa HTML (ciki har da Nau'in Motsi "Maida Layi Breaks" zaɓi), wasu nau'ikan za su canza kowane hutun layi zuwa <br /> Lakabi

Idan kaihakikaAna so a dogara da Markdown don sakawa <br /> Don lakabi, danna wurare biyu ko fiye a wurin sakawa sannan danna Shigar.

Lallai, yana ɗaukar ɗan ƙaramin aiki (ƙarin wurare) don samarwa <br /> , amma kawai "kowane sabon layi yana canzawa zuwa <br />"Hanyar ba ta dace ba a Markdown, em in MarkdownaiƘididdigar salon L-style da lissafin sakin layi masu yawa ba kawai sun fi amfani ba amma kuma sun fi sauƙin karantawa yayin buga rubutu tare da karya layi.

Take

Markdown yana goyan bayan kalmomi guda biyu don taken, Setext-like da atx-like.

Siffa mai kama da Settext shine nau'i tare da layin ƙasa, ta amfani da = (mafi girman lakabi) da - (Batun umarni na biyu), misali:

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

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

kowane adadin = kuma - zai iya zama tasiri.

Fom mai kama da Atx yana saka 1 zuwa 6 a farkon layin # , daidai da taken 1 zuwa 6, misali:

# 这是 H1

## 这是 H2

###### 这是 H6

Kuna iya zaɓin "kusa" masu kai kamar atx, wannan don ƙayatarwa ne kawai, idan kun ji daɗi ta wannan hanyar, zaku iya ƙara shi a ƙarshen layin. #, yayin da layin ya ƙare # Ba dole ba ne lambar ta kasance daidai da farkon (yawan haruffan fam a farkon layin yana ƙayyade tsari na take):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Ana amfani da blockquotes markup kamar waɗanda aka yi amfani da su a cikin imel > na ambato.Idan har yanzu kuna da masaniyar magana a cikin wasiƙun imel, kun san yadda ake ƙirƙira ƙa'idar toshe a cikin fayil ɗin Markdown, wanda zai yi kama da ku karya layin da kanku, sannan ƙara. > :

> 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 yana ba ku damar zama kasala kuma ƙara layin farko na duka sakin layi kawai > :

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

Ana iya shigar da nassoshi toshe (misali: nassoshi a cikin nassoshi) ta ƙara wani lamba daban > :

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

Hakanan ana iya amfani da wasu ƙa'idodin Markdown a cikin tubalan da aka nakalto, gami da kanun labarai, jeri, tubalan lamba, da sauransu:

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

Duk wani ingantaccen editan rubutu na iya ƙirƙirar kwatancen nau'ikan imel cikin sauƙi.Misali a cikin BBEdit zaku iya zaɓar rubutu sannan zaɓi daga menuƙara matsayi matsayi.

Lissafi

Markdown yana goyan bayan jerin sunayen da ba a ba da oda ba.

Lissafin da ba a ba da oda ba suna amfani da alamar alama, da alamu, ko ragi alamomi azaman alamomin jeri:

*   Red
*   Green
*   Blue

Daidai da:

+   Red
+   Green
+   Blue

Hakanan yayi daidai da:

-   Red
-   Green
-   Blue

Lissafin da aka ba da oda suna amfani da lambobi tare da lokaci:

1.  Bird
2.  McHale
3.  Parish

Yana da mahimmanci a lura cewa lambobin da kuke amfani da su a jerin tag ɗin ba su tasiri HTML ɗin da aka fitar ba.

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

Idan an rubuta alamar lissafin ku kamar:

1.  Bird
1.  McHale
1.  Parish

ko ma:

3. Bird
1. McHale
8. Parish

Dukanku za ku sami ainihin fitowar HTML iri ɗaya.Maganar ita ce, zaku iya sanya jerin lambobin da ke cikin fayil ɗin Markdown daidai da sakamakon fitarwa, ko kuma idan kun kasance malalaci, ba kwa buƙatar kula da daidaiton lambobin kwata-kwata.

Idan kun yi amfani da rubutun kasala, ana ba da shawarar farawa da 1. don abu na farko, saboda Markdown na iya goyan bayan sifa ta farkon jerin da aka ba da oda a nan gaba.

Alamar jerin abubuwan yawanci ana sanya su a hannun hagu mai nisa, amma ana iya sanya shi a ciki, har zuwa sarari 3, kuma alamar abu dole ne a bi shi da aƙalla sarari ɗaya ko tab.

Don sa lissafin ya yi kyau, zaku iya tsara abubuwan da ke ciki tare da kafaffen indent:

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

Amma idan kun kasance malalaci, hakan ma yayi kyau:

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

Idan jerin abubuwan an raba su ta hanyar layukan da babu komai, Markdown zai yi amfani da abun ciki yayin fitar da HTML. <p> An nannade takalmi, misali:

*   Bird
*   Magic

za a canza zuwa:

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

Amma wannan:

*   Bird

*   Magic

za a canza zuwa:

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

Abubuwan jeri na iya ƙunsar sakin layi da yawa, kuma sassan da ke ƙarƙashin kowane abu dole ne a sanya su ta wurare 4 ko shafi 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.

Ya yi kyau sosai idan kun sa kowane layi, ba shakka, kuma, idan kun kasance malalaci, Markdown kuma yana ba da izini:

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

Idan kana son sanya tunani a cikin jerin abubuwan, to > Yana buƙatar a sanya shi cikin ciki:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Idan kana son sanya katangar lamba, toshe yana buƙatar shigar da shisau biyu, wanda shine sarari 8 ko shafuka 2:

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

        <代码写在这>

Tabbas, jerin abubuwa na iya haifar da bazata, wani abu kamar haka:

1986. What a great season.

A wasu kalmomi, yana bayyana a farkon layinlamba-lokaci-blank, Don kauce wa wannan, za ka iya ƙara mayar da baya kafin lokacin.

1986\. What a great season.

code block

Rubutun da ke da alaƙa da shirin ko lambar tushen harshe yawanci yana da nau'in tubalan lambobi. Yawancin lokaci, ba ma son waɗannan tubalan su zama nau'in fayilolin sakin layi na gaba ɗaya, amma a nuna su yadda suke. Markdown zai yi amfani da shi. <pre> kuma <code> tags don kunsa tubalan code.

Tubalan ginin lamba a Markdown yana da sauƙi kamar shigar da sarari 4 ko shafi 1, misali, shigar da masu zuwa:

这是一个普通段落：

    这是一个代码区块。

Markdown zai canza zuwa:

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

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

An cire wannan shigarwar oda na farko a kowane layi (fasaha 4 ko shafin 1), misali:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

za a canza zuwa:

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

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

Toshe lambar yana ci gaba har sai layin da ba a bayyana ba (ko ƙarshen fayil ɗin).

A cikin code block, & , < kuma > Za a canza shi ta atomatik zuwa abubuwan HTML, wanda zai sauƙaƙa maka amfani da Markdown don saka lambar tushe HTML misali, kawai kwafi ka liƙa shi, ƙara indentation, sauran Markdown kuma zasu yi maka. misali:

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

za a canza zuwa:

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

A cikin toshe lambar, ba za a canza madaidaicin tsarin Markdown ba, kamar su asterisks taurari ne kawai, wanda ke nufin cewa zaku iya rubuta fayilolin da ke da alaƙa da Markdown cikin sauƙi a cikin Markdown syntax.

mai raba

Kuna iya ƙirƙirar mai rarrabawa tare da fiye da taurari uku, alamomin cirewa, jajirce a cikin layi, babu wani abu a cikin layi.Hakanan zaka iya saka sarari tsakanin alamomi ko ragi.Za a iya ƙirƙira layin rabuwa a kowane ɗayan waɗannan hanyoyin rubutu:

* * *

***

*****

- - -

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

kashi kashi

mahada

Markdown yana goyan bayan nau'ikan haɗin haɗin gwiwa guda biyu: Layin layikumaMagananau'i biyu.

Ko ta yaya, rubutun mahaɗin yana da alamar [square brackets].

don ƙirƙirar aLayin layiIdan kana son ƙara rubutun take na hanyar haɗin yanar gizo, kawai kunsa rubutun take tare da alamomi biyu bayan URL, misali:

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

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

Zai samar:

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

Idan kuna haɗawa da albarkatu akan mai masaukin baki ɗaya, zaku iya amfani da hanyoyin dangi:

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

MaganaAna biye da hanyar haɗin tare da wani shinge mai murabba'i bayan madaidaicin rubutun mahaɗin, kuma alamar da aka yi amfani da shi don gano hanyar haɗin ya kamata a cika shi a madaidaicin sashi na biyu:

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

Hakanan zaka iya sanya sarari da zaɓi tsakanin maƙallan murabba'i biyu:

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

Sannan, a ko'ina cikin fayil ɗin, zaku iya ayyana abubuwan haɗin yanar gizon wannan alamar:

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

An bayyana abun ciki na haɗin gwiwa a cikin tsari:

• Maƙallan murabba'i (na zaɓi wanda ya riga ya wuce har zuwa wurare uku don shigarwa) wanda aka shigar da rubutun hanyar haɗin gwiwa a ciki
• biye da hanji
• biye da ɗaya ko fiye da sarari ko shafuka
• URL na mahaɗin na gaba
• Da zaɓin bi abun ciki na take, wanda za'a iya haɗa shi cikin ƙididdiga guda ɗaya, ƙididdiga biyu, ko baƙaƙe

Ma'anonin mahaɗa guda uku masu zuwa iri ɗaya ne:

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

hankali:Akwai sanannen batun inda Markdown.pl 1.0.1 yayi watsi da taken mahaɗin da aka haɗa a cikin ƙididdiga ɗaya.

Hakanan za'a iya haɗa URLs na haɗin gwiwa a cikin maƙallan kusurwa:

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

Hakanan zaka iya sanya sifa ta take akan layi na gaba, ko ƙara wasu saƙo, wanda zai fi kyau idan URL ɗin ya yi tsayi sosai:

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

Ana amfani da ma'anar URL kawai lokacin samar da hanyoyin haɗin gwiwa, kuma ba sa bayyana kai tsaye a cikin fayil ɗin.

Alamun tantance hanyar haɗin gwiwa na iya ƙunsar haruffa, lambobi, farar fata, da alamar rubutu, amma karA'aYana da hankali, don haka hanyoyin haɗin gwiwa biyu masu zuwa iri ɗaya ne:

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

Tambarin hanyar haɗin kai tsayefasalin yana ba ku damar barin tantance alamar hanyar haɗin gwiwa. A wannan yanayin, alamar hanyar haɗin za a kula da ita daidai da rubutun hanyar haɗin gwiwa. Don amfani da alamar mahaɗin da ke fake, kawai ƙara madaidaicin madauri mara komai bayan rubutun mahaɗin. Idan kuna son "Google "Haɗin kai zuwa google.com, kuna iya sauƙaƙe zuwa:

[Google][]

Sannan ayyana abun cikin mahaɗin:

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

Tunda rubutun hanyar haɗin gwiwa na iya ƙunsar farin sarari, wannan sauƙaƙan alamar yana iya ƙunsar kalmomi da yawa:

Visit [Daring Fireball][] for more information.

Sannan a ci gaba da ayyana mahadar:

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

Ana iya sanya ma'anar mahada a ko'ina a cikin fayil ɗin, na fi so in sanya shi kai tsaye bayan sakin layi inda mahaɗin ya bayyana, Hakanan zaka iya sanya shi a ƙarshen fayil ɗin, kamar comment.

Ga misalin hanyar haɗin yanar gizo:

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"

Idan kun canza shi don amfani da sunan mahaɗin don rubuta:

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"

Hanyoyi biyu na sama na rubutu zasu samar da HTML mai zuwa.

<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 ƙasa akwai fayil ɗin Markdown na abun ciki iri ɗaya da aka rubuta ta layi, an tanadar don kwatanta:

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

A haƙiƙa, maƙasudin hanyoyin haɗin kai-style ba wai yana da sauƙin rubutawa ba, amma yana da sauƙin karantawa, kwatanta misalin da ke sama. Haruffa 81. , Idan an rubuta ta cikin tsantsar HTML, za a sami haruffa 176. A tsarin HTML, akwai tags fiye da rubutu.

Yin amfani da hanyoyin haɗin yanar gizo na Markdown, zaku iya sanya takaddar ta zama kamar sakamakon ƙarshe na mai binciken, yana ba ku damar matsar da wasu bayanan da ke da alaƙa a waje da rubutun sakin layi, kuma kuna iya ƙara hanyoyin haɗin gwiwa ba tare da sanya jin labarin labarin ba. .

Jaddada

Markdown yana amfani da taurari (asterisks)*) da kuma layin kasa (_) azaman alama don yiwa kalma mai layi, shine * 或 _ Kalmomin da ke kewaye suna juyawa zuwa <em> kewaye da lakabi, da biyu * 或 _Idan an nannade shi, za a maida shi <strong>,Misali:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

zai juya zuwa:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Kuna iya amfani da kowane salon da kuke so, iyakance kawai shine zaku iya amfani da alamar don buɗe alamar da alamar don ƙare ta.

Hakanan za'a iya shigar da girmamawa kai tsaye a tsakiyar rubutu:

un*frigging*believable

ammaidan ka * kuma _ Idan akwai farar fata a ɓangarorin biyu, ana ɗaukar su azaman alamomin al'ada.

Don saka alamomin al'ada ko jadada kai tsaye gabanin rubutu da bayan rubutu, zaku iya amfani da baya:

\*this text is surrounded by literal asterisks\*

Lambar

Idan kuna son yiwa ƙaramin lambar layin layi, zaku iya nannade shi a baya (`),Misali:

Use the `printf()` function.

Zai samar:

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

Idan kana son saka bayanan baya a cikin sashin lambar, zaku iya farawa da ƙare sashin lambar tare da maƙaloli masu yawa:

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

Wannan syntax yana haifar da:

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

Kuna iya sanya babu komai a farkon da ƙarshen sashin lambar, ɗaya bayan farkon ɗaya kuma kafin ƙarshen, don haka zaku iya saka bayanan baya a farkon sashin:

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

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

Zai samar:

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

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

A cikin sashin code,& da maƙallan kusurwa都za a canza ta atomatik zuwa abubuwan HTML, wanda ke sauƙaƙa saka lambar tushen HTML, Markdown zai sanya sakin layi mai zuwa:

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

zuwa:

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

Hakanan zaka iya rubuta wannan:

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

Don samarwa:

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

图片

Babu shakka, yana da wahala a ƙirƙira ma'anar "na halitta" don saka hotuna a cikin aikace-aikacen rubutu kawai.

Markdown yana amfani da tsarin aiki mai kama da na hanyoyin haɗin yanar gizo don yin alama, kuma yana ba da damar salo guda biyu: Layin layikumaMagana.

Sintax hoton layi yayi kama da:

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

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

Cikakkun bayanai sune kamar haka:

• alamar mamaki !
• biye da shinge mai murabba'i tare da alt rubutu don hoton
• Ana biye da wannan baƙaƙe na al'ada tare da URL na hoton, kuma a ƙarshe wani zaɓi na ' take' rubutu wanda ke rufe cikin ƙididdiga.

Rubutun mahallin hoto yayi kama da haka:

![Alt text][id]

"id" shine sunan ma'anar hoton, wanda aka siffanta shi daidai da hanyar haɗin yanar gizon:

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

Ya zuwa yanzu, Markdown ba shi da wata hanya ta tantance faɗin da tsayin hoton, idan kuna buƙata, zaku iya amfani da na yau da kullun. <img> Lakabi

其它

hanyar haɗin kai

Markdown yana goyan bayan sarrafa URLs da akwatunan saƙo na imel a cikin nau'ikan gajerun hanyoyin haɗin kai na atomatik. Muddin an lulluɓe su a maƙallan kusurwa, Markdown zai canza ta atomatik zuwa hanyar haɗi.Rubutun hanyar haɗin URL na gaba ɗaya daidai yake da adireshin mahaɗin, misali:

<http://example.com/>

Za a canza Markdown zuwa:

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

Haɗin kai ta atomatik na adiresoshin imel shima yayi kama da haka, sai dai Markdown zai fara aiwatar da tsarin jujjuya rubutu, yana mai da haruffan rubutu zuwa mahaɗan HTML hexadecimal.

<[email protected]>

Markdown zai juya zuwa:

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

A cikin browser, wannan kirtani (a zahiri <a href="mailto:[email protected]">[email protected]</a>) ya zama mahaɗin "[email protected]" wanda za'a iya dannawa.

(Ko da yake wannan hanya na iya yaudarar mutum-mutumi da yawa, ba zai iya hana su duka ba, amma ya fi komai kyau. A kowane hali, buɗe akwatin wasiku zai jawo hankalin haruffan talla.)

koma baya

Markdown na iya amfani da ja da baya don saka alamomin da ke da wasu ma'anoni a cikin nahawu, misali: idan kuna son ƙara alama kusa da rubutu don ƙarfafawa (amma ba <em> tag), zaku iya gaba da alamar alama tare da ja da baya:

\*literal asterisks\*

Markdown yana goyan bayan alamomin da ke gaba da baya don taimakawa saka alamomin gama gari:

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

Editan kyauta na Markdown

Dandalin Windows

• MarkdownPad
• MarkPad

Mac dandali

• m

editan kan layi

• MPEditor

browser plugin

• Markdown nan plugin

*** Idan akwai ingantaccen editan Markdown kyauta don bada shawara, da fatan za a kula da martaniChen Weiliang, godiya!