Zer esan nahi du Markdown hitzak? Nola erabili Markdown sintaxia/formatua markaketa?

MarkdownZer esan nahi du?

Nola erabili Markdown sintaxia/formatua markaketa?

Ikuspegi orokorra

Markdown John Gruber-ek sortutako markatze-lengoaia arina da.

Jendeari aukera ematen dio "dokumentuak irakurtzeko eta idazteko erraza den testu arrunteko formatuan idazteko, eta gero baliozko XHTML (edo HTML) dokumentu bihurtzeko".

Lengoaiak posta elektronikoan dagoeneko aurkitutako testu arrunteko markaketaren ezaugarri asko ditu.

John Gruberrek Markdown hizkuntza sortu zuen 2004an, Aaron Swartz-ekin lankidetzan, hein handi batean sintaxiaren inguruan.Lengoaiaren helburua da "irakurtzeko erraza, idazteko erraza den eta aukeran baliozko XHTML (edo HTML) bihurtzen den testu soila" erabiltzea.

helburua

Markdown-en helburua "irakurtzeko erraza eta idazteko erraza" izatea da.

irakurgarritasuna, egin hala ereInterneteko marketina, erabiltzailearen esperientzia oso garrantzitsua da.

Markdown-en idatzitako fitxategiak testu arruntean zuzenean argitaratu ahal izan behar du, eta ez luke etiketa edo formatu zuzentarau ugariz osatuta agertu behar.

Markdown-en sintaxia lehendik dauden testu-HTML formatu batzuek eragina dute, besteak beste, Setext, atx, Textile, reStructuredText, Grutatext eta EtText, baina inspirazio iturri handiena testu arrunteko posta elektronikoaren formatua da.

Laburbilduz, Markdown-en sintaxia ikurrez osatuta dago, arreta handiz hautatzen diren eta haien funtzioak begirada batean argiak dira.Adibidez: jarri izartxoak testuaren inguruan *enfasea* itxura izan dezan.

Markdown-eko zerrendek zerrenden itxura dute. Markdown-en bloke-aipuak testu zati bat aipatzea dirudi, mezu elektronikoetan ikusi duzun bezala.

HTMLrekin bateragarria

Markdown gramatikaren helburua sarerako idazteko hizkuntza izatea da.

Markdown-ek ez du HTML ordezkatu nahi, ezta bertara hurbildu ere, oso sintaxi gutxi du eta HTML markaketaren azpimultzo txiki bati dagokio. Markdown ez zen HTML dokumentuak idazteko errazago egiteko pentsatu.

Nire ustez, HTML jada idazteko erraza da. Markdown-en ideia dokumentuak irakurtzea, idaztea eta nahierara aldatzea erraztea da. HTML argitalpen formatua da, Markdown batIdazketaidatzizko formatua.Horrenbestez, Markdown-en formatu-sintaxiak testu arruntak ahal duena soilik estaltzen du.

Markdown-ek estaltzen ez dituen etiketak HTMLn idatz daitezke zuzenean dokumentuanWeb Sustapenakopiatu.Ez dago hau HTML edo Markdown gisa markatu beharrik; gehitu marka zuzenean.

HTML blokeko elementu batzuk soilik mugatu behar dira, adibidez <div>,<table>,<pre>,<p> eta beste etiketa batzuk, beste eduki-eremu batzuetatik bereizi behar dira aurretik eta ondoren lerro hutsekin, eta irekitzeko eta ixteko etiketak ez dira fitxekin edo zuriuneekin koskarik izan behar. Markdown sorgailua nahikoa adimentsua da alferrikako HTML bloke etiketak gehitzeko <p> Etiketa.

Adibidea honakoa da, Markdown fitxategiari HTML taula bat gehituz:

这是一个普通段落。

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

这是另一个普通段落。

Kontuan izan HTML blokeen etiketen arteko Markdown formatuaren sintaxia ez dela prozesatuko.Adibidez, HTML blokeen barruan Markdown estiloa erabiltzen baduzu*强调*ez du eraginik izango.

HTML ataleko (lerroan) etiketak adibidez <span>,<cite>,<del> Markdown paragrafoetan, zerrendetan edo goiburuetan libreki erabil daiteke.Ohitura pertsonalen arabera, HTML etiketak ere erabil ditzakezu formateatzeko Markdown formatua erabili gabe.Adibidez: HTML nahiago baduzu <a> edo <img> etiketak, Markdownek eskaintzen duen esteka edo irudi etiketa sintaxirik gabe zuzenean erabil daitezkeenak.

HTML blokeen etiketen artean ez bezala, Markdown sintaxia HTML ataleko etiketen artean balio du.

Karaktere berezien bihurketa automatikoa

HTML fitxategietan, tratamendu berezia behar duten bi karaktere daude: < 和 & . < ikurrak hasierako etiketetarako erabiltzen dira,& Sinboloak HTML entitateak markatzeko erabiltzen dira, karaktere horien prototipoa bistaratu nahi baduzu, entitate-inprimakia erabili behar duzu, adibidez < 和 &.

& Karaktereak bereziki oinazeak dira web dokumentuen idazleentzat, " idatziko baduzu "AT&T", idatzi behar duzu "AT&T".URLan dagoen bitartean & Pertsonaiak ere bihurtzen dira.Adibidez, estekatu nahi duzu:

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

URL bihurketa honela idatzi behar duzu:

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

estekaren etiketan jartzeko href propietateetan.Esan beharrik ez dago hau ezkutatzeko erraza dela, eta ziurrenik HTML estandarrak baliozkotzeak detektatu dituen errore kopuru handiena.

Markdownek karaktereak modu naturalean idazteko aukera ematen du, eta bihurtu beharrekoa zaintzen du.erabiltzen baduzu & Karaktere bat HTML karaktere-entitate baten parte da, dagoen bezala uzten da, bestela bihurtzen da &;.

Beraz, dokumentuan copyright ikur bat txertatu nahi baduzu ©, idatzi dezakezu:

©

Markdownek ukitu gabe utziko du.Eta idatziz gero:

AT&T

Markdown-ek honela bihurtuko du:

AT&T

urtean ere antzeko egoera gertatzen da < notazioa, Markdownek HTML bateragarritasuna ahalbidetzen duelako, jarriz gero < Sinboloak HTML etiketen mugatzaile gisa erabiltzen dira, eta Markdown-ek ez du horien gainean inolako bihurketarik egingo, baina idazten baduzu:

4 < 5

Markdown-ek honela bihurtuko du:

4 < 5

Hala ere, kontuan izan behar da kodearen esparruan, linean edo blokean dagoen, < 和 & sinbolo biakzihurHTML entitateetara bihurtzen dira, Markdown-en HTML kodea erraz idazteko aukera ematen duen funtzio bat (HTMLaren aurka, non jartzen dituzun < 和 & Guztiak HTML entitate bihurtzen dira, HTML kodea HTML fitxategian idazteko. )

bloke elementua

Paragrafoak eta lerro-jauziak

Markdown paragrafo bat ondoz ondoko testu-lerro bat edo gehiagoz osatuta dago, lerro huts bat baino gehiagoren aurretik eta ondoren (lerro zuri baten definizioa pantailan hutsik dagoela eta lerro hutstzat hartzen dela da. Adibidez, , lerro batek zuriuneak eta tabulazioak soilik baditu, lerroa lerro huts gisa ere tratatuko da).Paragrafo arruntek ez dute zuriunez edo tabulazioz koskarik izan behar.

"Testu lerro bat edo gehiagoz osatuta" esaldiak benetan esan nahi du Markdown-ek lerro berriak behartuta (lerro berriak txertatzea) baimentzen dituela paragrafoetan, beste testurako HTML formatu gehienen desberdina den ezaugarri bat (mota mugikorra barne, "Bihurtu lerro-jauziak"). " aukera), beste formatu batzuek lerro-jauzi bakoitza bihurtuko dute <br /> Etiketa.

Zu bazaraHain zuzen ereMarkdown-en fidatu nahi txertatzeko <br /> Etiketak egiteko, sakatu bi zuriune edo gehiago txertatzeko lekuan eta, ondoren, sakatu Sartu.

Izan ere, lan pixka bat gehiago behar da (espazio gehigarriak) sortzeko <br /> , baina besterik gabe "lerro berri guztiak bihurtzen dira <br />"Metodoa ez da egokia Markdown-en, Markdown-enaiL estiloko blokeko komatxoak eta paragrafo anitzeko zerrendak erabilgarriagoak izateaz gain, irakurtzeko errazagoak dira lerro-jauziekin idaztean.

Titularra

Markdown-ek bi sintaxi onartzen ditu goiburuetarako, Setext-like eta atx-like.

Settext-like forma beheko lerroa duen inprimakia da, erabiliz = (titulu gorena) eta - (Bigarren ordenako goiburuak), adibidez:

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

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

edozein kopuru = 和 - eraginkorra izan daiteke.

Atx itxurako formak 1etik 6ra txertatzen du lerroaren hasieran # , 1etik 6ra bitarteko epigrafeei dagozkienak, adibidez:

# 这是 H1

## 这是 H2

###### 这是 H6

Aukeran "itxi" ditzakezu atx antzeko goiburuak, hau estetika hutsa da, horrela eroso sentitzen bazara, lerroaren amaieran gehi dezakezu #, lerro amaierak bitartean # Zenbakiak ez du zertan hasierako berdina izan (lerroaren hasierako kilo karaktere kopuruak baldintzatzen du izenburuaren ordena):

# 这是 H1 #

## 这是 H2 ##

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

Blokeko komatxoak Blokeko komatxoak

Markdown markaketa blokeo komatxoak posta elektronikoan erabiltzen direnen antzera erabiltzen dira > aipamenak.Posta elektronikoko letren komatxoak ezagutzen badituzu, badakizu Markdown fitxategi batean bloke-aipamen bat nola sortu, zuk zeuk lerroak hautsi eta gero gehitu > :

> 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-ek alferra izatea eta paragrafo osoaren lehen lerroa bakarrik gehitzeko aukera ematen du > :

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

Bloke-erreferentziak habiaratu daitezke (adibidez: erreferentziak erreferentzien barruan) beste kopuru bat gehituz > :

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

Markdown-eko beste sintaxi batzuk ere erabil daitezke komatxoen barruan, goiburuak, zerrendak, kode blokeak eta abar barne:

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

Edozein testu editore duin erraz sor ditzake posta elektronikoaren estiloko aipamenak.Adibidez, BBEdit-en testua hauta dezakezu eta gero menutik aukeratuaipamen-hierarkia handitzea.

zerrenda

Markdown-ek zerrenda ordenatuak eta ordenatuak onartzen ditu.

Ordenatu gabeko zerrendek izartxoak, gehi zeinuak edo minus zeinuak erabiltzen dituzte zerrenda-markatzaile gisa:

*   Red
*   Green
*   Blue

Honen baliokidea:

+   Red
+   Green
+   Blue

Honen baliokidea ere:

-   Red
-   Green
-   Blue

Zerrenda ordenatuek zenbakiak erabiltzen dituzte eta ondoren puntu bat:

1.  Bird
2.  McHale
3.  Parish

Garrantzitsua da kontuan izan zerrenda-etiketan erabiltzen dituzun zenbakiek ez dutela irteerako HTML-an eragiten. Goiko zerrendako HTML markaketa hau izango litzateke:

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

Zure zerrendako marka honela idatzita badago:

1.  Bird
1.  McHale
1.  Parish

edo baita ere:

3. Bird
1. McHale
8. Parish

Biek HTML irteera berdina lortuko duzue.Kontua da, Markdown fitxategiko zerrenda-zenbakiak irteerako emaitzen berdinak izan ditzakezu, edo alferra bazara, ez duzu zenbakien zuzentasunaz arduratu beharrik.

Idazketa alferra erabiltzen baduzu, lehen elementurako 1.-tik hastea gomendatzen da, etorkizunean Markdown-ek zerrenda ordenatuen hasierako atributua onar dezakeelako.

Zerrendako elementuen etiketa ezkerreko muturrean jarri ohi da, baina koska izan daiteke, gehienez 3 espazio, eta elementuaren etiketari gutxienez zuriune edo fitxa bat jarri behar zaio.

Zerrenda politagoa izan dadin, edukiak koska finko batekin antola ditzakezu:

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

Baina alferra bazara, hori ere ondo dago:

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

Zerrendako elementuak lerro hutsez bereizten badira, Markdown-ek elementuaren edukia erabiliko du HTML irteeran. <p> Etiketak bilduta daude, adibidez:

*   Bird
*   Magic

honela bihurtuko da:

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

Baina hau:

*   Bird

*   Magic

honela bihurtuko da:

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

Zerrendako elementuek hainbat paragrafo izan ditzakete, eta elementu bakoitzaren azpian dauden paragrafoek 4 zuriunez edo fitxa batekin koska izan behar dute:

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.

Askoz hobeto ikusten da lerro bakoitza koska egiten baduzu, noski, berriro ere, alferra bazara, Markdownek ere aukera ematen du:

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

Zerrendako elementu baten barruan erreferentzia bat jarri nahi baduzu, orduan > Koska egin behar da:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Kode bloke bat jarri nahi baduzu, blokea koska egin behar daBi aldiz, hau da, 8 espazio edo 2 fitxa:

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

        <代码写在这>

Jakina, nahi gabe elementuen zerrenda bat sor daiteke, honelako zerbait:

1986. What a great season.

Alegia, lerroaren hasieran agertzen dazenbakia-punta-hutsik, hori saihesteko, puntuaren aurretik atzera-barra gehi dezakezu.

1986\. What a great season.

kodea blokea

Programarekin erlazionatutako idazketa edo etiketa-hizkuntzako iturburu-kodeak normalean dagoeneko konposatutako kode-blokeak ditu. Normalean, ez dugu nahi bloke hauek paragrafo-fitxategi orokorren moduan konposatuak izatea, baina dauden bezala bistaratu. Markdown-ek erabiliko du. <pre> 和 <code> etiketak kode blokeak biltzeko.

Markdown-en kode-blokeak sortzea 4 espazio edo fitxa bat koska egitea bezain erraza da. Adibidez, idatzi honako hau:

这是一个普通段落：

    这是一个代码区块。

Markdown honela bihurtuko da:

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

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

Lerro bakoitzeko lehen mailako koska hau (4 zuriune edo fitxa bat) kendu egiten da, adibidez:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

honela bihurtuko da:

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

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

Kode bloke batek koskarik gabeko lerrora arte (edo fitxategiaren amaierara arte) jarraitzen du.

Kode blokearen barruan, & , < 和 > Automatikoki bihurtuko da HTML entitateetan, eta horrek oso erraza da Markdown erabiltzea adibiderako HTML iturburu-kodea txertatzeko, kopiatu eta itsatsi, koska gehitu eta gainerako Markdownek kudeatuko dizu. adibidez:

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

honela bihurtuko da:

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

Kode blokean, Markdown sintaxi orokorra ez da bihurtuko, hala nola izartxoak izartxoak besterik ez dira, hau da, Markdown sintaxiarekin erlazionatutako fitxategiak erraz idatzi ditzakezu Markdown sintaxian.

banatzailea

Hiru izartxo baino gehiago erabil ditzakezu, minus zeinuak, azpimarra lerro batean zatitzailea sortzeko, lerroan beste ezer.Izartxoen edo minus zeinuen artean zuriuneak ere sar ditzakezu.Bereizketa-lerroak idazteko modu hauetako bakoitzean sor daitezke:

* * *

***

*****

- - -

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

atalaren elementua

链接

Markdown-ek bi esteken sintaxi mota onartzen ditu: Sarean和Erreferentziabi forma.

Nolanahi ere, estekaren testua [kortxetez] markatzen da.

bat sortzekoSareanEstekaren izenburuaren testua gehitu nahi baduzu, jarri izenburuaren testua komatxo bikoitzekin URLaren ondoren, adibidez:

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

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

Ekoiztuko du:

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

Ostalari bereko baliabideekin lotzen ari bazara, bide erlatiboak erabil ditzakezu:

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

ErreferentziaEstekaren atzetik beste kortxete bat dago estekaren testuaren kortxetearen ondoren, eta esteka identifikatzeko erabilitako marka bigarren kortxetean bete behar da:

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

Bi kortxeteen artean tarte bat ere jar dezakezu aukeran:

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

Ondoren, fitxategiko edozein lekutan, etiketa honen estekaren edukia defini dezakezu:

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

Estekaren edukia forma honetan definitzen da:

• Kortxete karratuak (aukeran hiru zuriune jarri aurretik koska egiteko) estekaren testua sartzen den
• ondoren, bi puntu
• ondoren, zuriune edo fitxa bat edo gehiago
• hurrengo estekaren URLa
• Aukeran jarraitu izenburuaren edukia, komatxo bakarrean, komatxo bikoitzetan edo parentesi artean sar daitekeena.

Hurrengo hiru esteken definizioak berdinak dira:

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

kontuz:Arazo ezagun bat dago non Markdown.pl 1.0.1-ek komatxo bakarren artean sartutako esteken izenburuak alde batera uzten dituen.

Estekaren URLak parentesi angelu artean ere sar daitezke:

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

Izenburuaren atributua ere jar dezakezu hurrengo lerroan, edo koska bat gehi dezakezu, URLa luzeegia bada itxura hobea izango duena:

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

URL definizioa esteka sortzean bakarrik erabiltzen da, eta ez da zuzenean fitxategian agertzen.

Estekaren identifikazio-etiketek hizkiak, zenbakiak, zuriuneak eta puntuazioa izan ditzakete, baina ezEzMaiuskulak eta minuskulak bereizten ditu, beraz, bi esteka hauek berdinak dira:

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

Esteka inplizitua etiketaeginbideak estekaren etiketa bat zehaztea ezabatzeko aukera ematen du. Kasu honetan, estekaren etiketa estekaren testuaren baliokide gisa tratatuko da. Esteka etiketa inplizitua erabiltzeko, gehitu kortxete huts bat estekaren testuaren ondoren. "Google" nahi baduzu. " Google.com-era estekatuta, honela sinplifikatu dezakezu:

[Google][]

Ondoren, zehaztu estekaren edukia:

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

Estekaren testuak zuriuneak izan ditzakeenez, marka sinplifikatu honek hainbat hitz izan ditzake:

Visit [Daring Fireball][] for more information.

Ondoren, joan esteka definitzen:

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

Estekaren definizioa artxiboko edozein tokitan jar daiteke.Nahiago dut zuzenean esteka agertzen den paragrafoaren ondoren jartzea.Fitxategiaren amaieran ere jar dezakezu, iruzkin bat bezala.

Hona hemen erreferentzia-esteka baten adibide bat:

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"

Aldatzen baduzu estekaren izena erabiltzeko idazteko:

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"

Aurreko bi idazteko moduek honako HTML hau sortuko dute.

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

Jarraian, lerroan idatzitako eduki bereko Markdown fitxategi bat dago, alderatzeko emandakoa:

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

Izan ere, erreferentzia-estiloko esteken puntua ez da idazteko errazagoa dela, irakurtzeko errazagoa dela baizik. Konparatu goiko adibidea. Erreferentzia-estiloko artikuluak berak 81 karaktere baino ez ditu, baina lerroko formak handitu egingo du. 176 karaktere. , HTML formatu hutsean idatzita badago, 234 karaktere izango dira. HTML formatuan, testua baino etiketa gehiago daude.

Markdown-en erreferentzia-estiloko estekak erabiliz, dokumentua nabigatzailearen azken emaitzaren antza gehiago egin dezakezu, markaketarekin lotutako metadatu batzuk paragrafoko testutik kanpo mugitzeko aukera emanez, eta estekak gehi ditzakezu artikuluaren irakurketa-sentimendua egin gabe. .

强调

Markdownek izartxoak erabiltzen ditu (*) eta beheko lerroa (_) azpimarratutako hitz bat markatzeko ikur gisa, da * edo _ Inguratutako hitzak bihurtzen dira <em> etiketaz inguratuta, birekin * edo _Itzulduta badago, bihurtuko da <strong>,adib.:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

bihurtuko da:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Nahi duzun estiloa erabil dezakezu, muga bakarra etiketa zein ikurrekin amaitu nahi duzun ireki dezakezula da.

Azpimarra ere zuzenean txerta daiteke testuaren erdian:

un*frigging*believable

bainazure bada * 和 _ Bi aldeetan zuriuneak badaude, sinbolo arrunt gisa tratatzen dira.

Testuaren aurretik eta ondoren zuzenean izartxo edo azpimarra arruntak txertatzeko, atzera barra erabil dezakezu:

\*this text is surrounded by literal asterisks\*

Kodea

Sareko kode zati txiki bat markatu nahi baduzu, atzealdean bildu dezakezu (`), adibidez:

Use the `printf()` function.

Ekoiztuko du:

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

Kode-atal baten barruan atzera-tick-ak txertatu nahi badituzu, kode-atala hainbat atzetik hasi eta amaitu dezakezu:

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

Sintaxi honek sortzen du:

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

Kode-atal baten hasieran eta amaieran hutsune bat jar dezakezu, bat hasieraren ondoren eta beste bat amaieraren aurretik, atalaren hasieran atzera-tickak txertatzeko:

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

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

Ekoiztuko du:

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

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

Kode atalaren barruan,& eta angelu-parentesiak都automatikoki bihurtuko da HTML entitateetara, eta horrek HTML iturburu kodea txertatzea errazten du, Markdown-ek paragrafo hau jarriko du:

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

honetara:

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

Hau ere idatzi dezakezu:

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

Ekoizteko:

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

图片

Jakina, zaila da testu-aplikazio batean irudiak txertatzeko sintaxi "naturala" bat diseinatzea.

Markdown-ek esteken antzeko sintaxia erabiltzen du irudiak markatzeko, eta bi estilo ere onartzen ditu: Sarean和Erreferentzia.

Inline irudiaren sintaxiak itxura hau du:

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

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

Xehetasunak hauek dira:

• harridura ikurra !
• ondoren, kortxete bat dago irudiaren alt testuarekin
• Horren ondoren, parentesi arruntak daude irudiaren URLarekin, eta azkenik, "izenburua" aukerako testu bat komatxo artean sartuta.

Erreferentzia-irudiaren sintaxia honelakoa da:

![Alt text][id]

"id" irudiaren erreferentziaren izena da, esteka-erreferentziaren modu berean definitzen dena:

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

Orain arte, Markdownek ez du irudiaren zabalera eta altuera zehazteko modurik, behar izanez gero, normala erabil dezakezu. <img> Etiketa.

其它

esteka automatikoa

Markdown-ek URLak eta posta elektronikoko postontzien prozesatzea onartzen du esteka automatiko labur samarretan. Angelu-kotxeen artean sartuta dauden bitartean, Markdown-ek automatikoki esteka bihurtuko du.URL orokor baten estekaren testua estekaren helbidearen berdina da, adibidez:

<http://example.com/>

Markdown honela bihurtuko da:

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

Helbide elektronikoen esteka automatikoa ere oso antzekoa da, izan ezik, Markdownek lehenik kodetze-bihurketa-prozesu bat egingo du, testu-karaktereak HTML hamaseitar entitate bihurtuz. Formatu honek helbide elektronikoak biltzeko robot txar batzuk engainatu ditzake, hala nola:

<[email protected]>

Markdown honela bihurtuko da:

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

Arakatzailean, kate hau (benetan <a href="mailto:[email protected]">[email protected]</a>) klika daitekeen "[email protected]" esteka bihurtzen da.

(Ikuspegi honek robot asko engainatu ditzakeen arren, ezin ditu denak gelditu, baina ezer baino hobea da. Edonola ere, zure postontzia irekitzeak publizitate gutunak erakarriko ditu azkenean.)

atzerako barra

Markdownek kontrako barrak erabil ditzake gramatikan beste esanahi batzuk dituzten sinboloak txertatzeko, adibidez: testuaren ondoan izartxo bat gehitu nahi baduzu azpimarratzeko (baina ez <em> etiketa), izartxoaren aurretik egin dezakezu atzera barra batekin:

\*literal asterisks\*

Markdown-ek sinbolo hauek onartzen ditu atzera-barra baten aurretik, ikur arruntak sartzen laguntzeko:

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

Markdown doako editorea

Windows plataforma

• MarkdownPad
• MarkPad

Mac plataforma

• bigunak

sareko editorea

• MPEditor

arakatzailearen plugina

• Markdown hemen plugina

*** Doako Markdown editore hobe bat gomendatzeko badago, mesedez jarri arreta iritziaChen Weiliang, eskerrik asko!