Laguntza

Markdown formatua erabili web orriak idazteko

(Testu hau Markdown sintaxi-orri originalaren kopia da)

Filosofia

Markdownen asmoa da ahal bezain irakurterraza eta idazterraza izatea.

Garrantzitsuena, dena den, irakurterraza izatea da. Markdown formatua duen dokumentuak diren bezalakoak argitaratzeko modukoak izan behar dute, testu lau gisa, etiketekin edo formatu-argibideekin hobetu direnaren antza eduki gabe. Markdownen sintaxian eragina izan dute dauden HTML iragazki bihurgailu batzuk �Setext, atx, Textile, reStructuredText, Grutatext eta EtText barne�; baina, Markdownen sintaxirako inspirazio-iturri nagusia posta elektronikoaren testu laua da.

Markdownen sintaxia puntuazio-zeinuez osatua dago; zeinuak kontu handiz aukeratuta daude, esan nahi dutenaren irudia izan dezaten. Adibidez, hitzen inguruko asteriskoak *emphasis* gisa agertzen dira. Markdown-zerrendek horixe dirudite, zerrendak. Aipuek ere testu-zati itxura dute.

HTML linean

Markdownen helburua hau da: weberako idazteko formatu gisa erabiltzea.

Markdown ez da HTMLren ordezkoa, ez da antzekoa ere. Sintaxia oso mugatua da, HTML etiketen azpimultzo txiki bat bakarrik hartzen du. Asmoa ez da HTMLn etiketak errazago sartzeko sintaxi bat sortzea. Nire iritziz, HTML etiketak sartzen errazak dira dagoeneko. Markdownen xedea da testua irakurtzeko, idazteko eta editatzeko erraza izatea. HTML argitaratzeko formatu bat da, Markdown, berriz, idaztekoa. Gainera, Markdown formatuko sintaxia testu lauan adierazi daitekeen edukian bakarrik erabiltzekoa da.

Markdownek hartzen ez dituen marketan, HTML bera erabil dezakezu. Ez daukazu zertan adierazi behar Markdownetik HTMLra pasa zarela; etiketak erabili besterik ez duzu.

Muga bakarrak HTML blokeetan daude (adibidez: <div>, <table>, <pre>, , e.a.); izan ere, inguratzen dituen edukiaz lerro hutsekin bereiztu behar dira eta blokearen hasierako eta bukaerako etiketek ez dute tabuladorerik eta espaziorik eduki behar. Markdown bizkorra da: ez ditu  etiketa gehigarriak (nahi ez direnak) jartzen HTML blokeen etiketen inguruan.

Adibidez, HTML taula bat Markdown artikulu batean jartzeko:

Hau paragrafo normal bat da.

<table>

��� <tr>

������� <td>Foo</td>

��� </tr>

</table>

Hau beste paragrafo normal bat da.

Markdown formatuaren sintaxia ez da HTML blokeetako etiketen barruan prozesatzen. Adibidez: ezin da *emphasis* estiloa HTML bloke baten barruan erabili.

Spaneko HTML etiketak (adibidez: , <cite>, o <del>) Markdownen edozein paragrafo, item-zerrenda edo goiburutan erabil daitezke. Nahi baduzu, Markdown formatuaren ordez HTML etiketak erabil ditzakezu; esaterako, Markdownen esteken edo irudien sintaxiaren ordez <a> o <img> HTML etiketak erabil ditzakezu.

HTMLren bloke-etiketak ez bezala, Markdownen sintaxia span etiketen barruan prozesatzen da.

Karaktere berezietarako ihes automatikoa

HTMLn bi ikurrek tratamendu berezia behar dute: < eta &. Ezker angeluaren ikurra etiketak hasteko erabiltzen da eta ampersand direlakoak entitateak adierazteko. Ikur literal gisa erabili nahi badituzu, ihes-karaktereak erabili behar dituzu markatzeko; adibidez: <, y &.

Ampersand direlakoak web-idazleentzat oztopo besterik ez dira. �AT&T� adierazteko �AT&T� idatzi behar da. URLetan ere ampersandetan ihesa aplikatu behar da. Orrialde honetarako lotura egin nahi baduzu:

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

URL era honetan kodetu behar duzu:

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

href etiketaren atributuan. Hori erraz ahazten da; horregatik, HTML akatsen iturri nagusia da.

Markdownek ikur horiek natural erabiltzeko aukera ematen du, ihesak sistemak berak egiten ditu. Ampersand HTML entitate baten zati gisa erabiltzen baduzu, ez du aldatzen; bestela, & itzuliko litzateke.

Beraz, artikuluan copyright ikurra jarri nahi baduzu, hau idatz dezakezu:

&copy;

eta Markdownek bere horretan utziko du. Aldiz, hau idazten baduzu:

AT&T

Markdownek era honetan itzuliko du:

AT&amp;T

Halaber, Markdownek lineako HTML onartzen duenez, angelu-ikurrak HTML etiketak mugatzeko erabiltzen badituzu, Markdownek bere horretan hartuko ditu. Baina, hau idazten baduzu:

4 < 5

Markdownek era honetan itzuliko du:

4 &lt; 5

Hala eta guztiz, Markdown kodean, spanak eta blokeak, angeluak eta ampersandak beti automatikoki kodetzen dira. Horregatik, Markdown HTML kodean idazteko erabilerraza da (HTML sintaxiaren gainean idaztea, ordea, nekagarria da, < eta & ikurrek ihesa behar dutelako).

Paragrafoak eta lerro-jauziak

Paragrafo bat lerro zuri batek edo gehiagok bereiztutako goitik beherako eta ondoz ondoko testu-lerroez osatua dago. (Lerro zuria itxura hori duen edozein lerro da; tabulazioak edo zuriuneak dituen edozein lerro lerro zuritzat hartzen da). Paragrafo normalei ez zaie koskarik jarri behar.

�Ondoz ondoko testu-lerroak� edukitzeak esan nahi du Markdownek �hard-wrapped� testuen paragrafoak onartzen dituela (Movable Typeko �Lerro-jauziak bihurtzea� aukera barne. HTML testua formateatzeko gainerako sistemek ez dute aukera hori ematen; izan ere, lerro-jauziak   markan itxitako par�grafo bihurtzen dituzte.

Markdownen lerro-jauziaren   marka sartu nahi baduzu, lerro bat bi zuriune edo gehiagorekin amaitu eta gero jauzi-tekla sakatu besterik ez duzu.

Nekezagoa da   bat sortzea baino, baina �lerro-jauzi bakoitza   da� arauak ez du funtzionatzen Markdownen. Markdownen blockquoting e-posta estiloak eta list items paragrafo-anitzak hobeto funtzionatzen dute (eta itxura hobea dute) lerro-jauzi gogorrekin formateatzen badira.

Goiburuak

Markdownek bi goiburu-estilo onartzen ditu: Setext eta atx.

Setext estiloko goiburuak �azpimarratuta� daude eta �=� ikurra (lehen mailako goiburuetan) eta �-� marratxo motzak (bigarren mailako goiburuetan) erabiltzen dituzte. �Adibidez:

Hau H1 da

=============

Hau H2 da

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

Edozein zenbaki-ikurrek funtzionatuko du: =; edo -;.

Atx estiloko goiburuek lerro bakoitzaren hasieran 1-6 traol erabiltzen dituzte; traol horiek goiburuen mailei dagozkie. Adibidez:

# Hau H1 da.

## Hau H2 da

###### Hau H6 da.

Nahi baduzu, Atx estiloko goiburuak itxi ditzakezu. Hori erabat kosmetikoa da; aukera hori erabil dezakezu, hobeto geratzen dela iruditzen bazaizu. Ixteko traol-kopuruak ez du zertan goiburua irekitzeko traol-kopuru berbera izan behar. (Irekierako traol-kopuruak goiburuan maila zehazten du). :

# Hau H1 da #

## Hau H2 da ##

### Hau H3 da ######

Aipuak

Markdownek e-postaren antzeko > karaktereak erabiltzen ditu. E-postako mezuetan aipuak jartzen ohituta bazaude, seguru asko jakingo duzu Markdownen aipuak sortzen. �Itxura hobea izaten du lerro-jauzi gogorrak erabiltzen badituzu eta lerro bakoitzaren aurrean > jartzen baduzu:

> Hau bi paragrafoko aipu bat da. 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.

Markdownek nagi izatek baimena ematen dizu; beraz, lerro-jauzi gogordun paragrafoak osatu eta lehen lerroaren aurrean > jarri besterik ez duzu.

> Hau bi paragrafoko aipu bat da. 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.

Aipuak habiaratu egin daitezke (adibidez: aipu bat beste baten barruan jar daiteke) > maila gehigarriak jarrita:

> Hau aipuaren lehen maila da.

> > Hau aipu habiaratua da.

> Lehen mailara bueltatzea.

Aipuek beste Markdown elementu batzuk izan ditzakete, goiburuak, zerrendak eta kode-blokeak barne:

> ## Hau goiburu bat da.

> 1.�� Hau zerrendako lehen itema da.

> 2.� Hau zerrendako bigarren itema da.

> Hona hemen kodeen adibide batzuk:

>���� return shell_exec("echo $input | $markdown_script");

Edozein testu-editore txukunek e-posta moduko aipuak jartzea erraztu beharko luke. BBEditekin, adibidez, hautaketa bat egin eta Text menuan Increase Quote Level aukera dezakezu.

Zerrendak

Markdownek ordenatutako zerrendak (zenbakidunak) eta ordenatu gabeko zerrendak (bi�etadunak) onartzen ditu.

Ordenatu gabeko zerrendetan asteriskoak, + ikurra eta gidoiak erabiltzen dira zerrenda-markagailu gisa:

*�� Gorria

*�� Berdea

*�� Urdina

hauen baliokideak dira:

+� Gorria

+� Berdea

+� Urdina

baita hauen baliokideak ere:

-�� Gorria

-�� Berdea

-�� Urdina

Ordenatutako zerrendetan zenbakiak erabiltzen dira, ondoren puntua jarrita:

1.� Bird

2.� McHale

3.� Parish

Zerrenda markatzen erabiltzen diren zenbakiek ez dute eraginik Markdownen sortutako HTML irteeran. Aurreko zerrendaren HTML irteera hau da:

<ol>

<li>Bird</li>

<li>McHale</li>

<li>Parish</li>

</ol>

Aldiz, Markdownen zerrenda honela idatziz gero:

1.� Bird

1.� McHale

1.� Parish

edo honela:

3. Bird

1. McHale

8. Parish

HTML irteera berbera izango da. Gauzak horrela, Markdownen zerrenda ordenatuetan zenbaki ordinalak erabil ditzakezu, iturri-kodeko zenbakiak argitaratutako HTMLren zenbakiekin bat etor daitezen. Nagi izatea aukeratzen baduzu, ez daukazu hori egin beharrik.

Dena den, zenbaki nagiak erabili nahi badituzu, zerrenda 1 zenbakiarekin hasi behar duzu. Aurrera begira, Markdownek ordenatutako zerrendak edozein zenbakirekin hastea onartuko du.

Zerrendako markagailuak normalean ezkerreko marjinan hasten dira, baina koska utz daiteke, gehienez hiru zuriunekoa. Zerrenda-markagailuen ondoren zuriune bat edo gehiago edo tabulazio bat utzi behar da.

Zerrendak ondo geratzeko, itemak koska zintzilikatuekin bereiz daitezke:

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

Nagi izatea aukeratzen baduzu, ordea, hori egin beharrik ere ez duzu:

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

Itemak lerro zuriekin bereiztuta badaude, Markdownek itemak  markatan banatuko ditu HTML irteeran. Sarrera hau, adibidez:

*�� Bird

*�� Magic

hau bihurtuko da:

<ul>

<li>Bird</li>

<li>Magic</li>

</ul>

Hau, ordea:

*�� Bird

*�� Magic

hau bihurtuko da:

<ul>

<li><p>Bird</p></li>

<li><p>Magic</p></li>

</ul>

Zerrendako itemek hainbat paragrafo izan ditzakete. Paragrafoei koska jarri behar zaie, 4 zuriunekoa edo tabulazio batekoa:

1.� Hau bi paragrafoko item bat da. 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.

Paragrafoetako lerroei koska uzteak testuari itxura hobea ematen dio, baina Markdownek nagi izaten uzten dizu:

*�� Hau bi paragrafoko itema da.

��� Hau zerrendako itemaren bigarren paragrafoa da. Lehen lerroan bakarrik eskatzen da koska uztea. Lorem ipsum dolor

sit amet, consectetuer adipiscing elit.

*�� Zerrendako beste item bat.

Zerrendako item batean aipu bat sartzeko, aipuko mugatzaileek koska eduki behar dute:

*�� Zerrendako item bat aipu batekin:

��� > Hau aipu bat da

��� > zerrendako item baten barruan.

Kode-bloke bat zerrenda bateko item batean sartzeko, kode-blokeak bi koska izan behar ditu (zortzi zuriune edo bi tabulazio):

*� Zerrendako item bat kode-bloke batekin:

������� <kodea hemen jarri behar da>

Esan beharra dago konturatu gabe zerrenda ordenatu bat has daitekeela, era honetako zerbait idatzita:

1986. What a great season.

Hau da, lerro hasieran zenbaki bat, puntu bat eta zuriune bat segidan jarrita. Hori ez gertatzeko, puntuaren aurretik barra alderantzikatu bat (\) jar dezakezu:

1986\. What a great season.

Kode-blokeak

Aurretik formateatutako kode-blokeak programazioan edo marken iturri-kodean idazteko erabiltzen dira. Paragrafo normalak osatu beharrean, kode-blokeetako lerroak hitzez hitz interpretatzen dira. Markdownek kode-blokeak <pre> zein <code> marketan mugitzen ditu.

Markdownen kode-bloke bat egiteko, blokeko lerroei gutxienez lau zuriuneko edo tabuladore bateko koska utzi besterik ez dago. Sarrera honekin, adibidez:

Hau paragrafo normal bat da.

��� Hau kode-bloke bat da.

Markdownek hau sortuko du:

<p>Hau paragrafo normal bat da:<p>

<pre><code>Hau kode-bloke bat da.

</code></pre>

Koska-maila (lau zuriune edo tabuladore bat) mugitu egiten da kode-blokeko lerro bakoitzetik. Hau, adibidez:

Hona hemen AppleScripten adibide bat:

��� tell application "Foo"

������� beep

��� end tell

hau bihurtuko da:

<p>Hona hemen AppleScripten adibide bat:<p>

<pre><code>tell application "Foo"

��� beep

end tell

</code></pre>

Kode-blokeek koskarik gabeko lerro batera heldu arte (edo artikuluaren bukaerara arte) jarraitzen dute.

Kode-blokean, ampersandak (&) eta angelu-kortxeteak (< y >) HTML entitate bihurtzen dira automatikoki. Hala, Markdown medio HTML iturri-kodeak adibide gisa jartzea erraza da: erantsi eta koska jarri besterik ez da egin behar; a bilduak eta angelu-kortxeteak Markdownek kodetuko ditu. Hau, adibidez:

��� <div class="footer">

������� &copy; 2004 Foo Corporation

��� </div>

hau bihurtuko da:

<pre><code>&lt;div class="footer"&gt;

��� &amp;copy; 2004 Foo Corporation

&lt;/div&gt;

</code></pre>

Markdown formatuaren ohiko sintaxia ez da bloke-kodeen barruan prozesatzen. Asteriskoak, adibidez, asteriskoak dira bloke-kodean. Horrek esan nahi du Markdownen sintaxiaren gainean idazteko Markdown erabiltzea oso erraza dela.

Erregela horizontalak

Erregela horizontalek marka bat sor dezakezu (<hr />), lerro batean hiru marratxo edo gehiago edo hiru asterisko gehiago idatzita. Nahi izanez gero, marratxoen eta asteriskoen artean zuriuneak utz ditzakezu. Lerro hauek lerro horizontalak sortuko dituzte:

* * *

***

*****

- - -

Span Elements

Estekak

Markdownek bi estiloko estekak onartzen ditu: lineakoak eta erreferentziak.

Bi estiloetan, estekako testua [kortxeteek] mugatzen dute.

Lineako estekak sortzeko, estekaren testuko itxiera-kortxetearen ondoren bi parentesi arrunt jarri besterik ez da egin behar. Parentesi artean URLa jarri behar da eta ondoan aukerako estekaren izenburua, komatxo artean. Honek, adibidez:

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

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

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

Zerbitzari bereko tokiko baliabide bat aipatzen ari bagara, erreferentzia erlatiboak erabil ditzakegu:

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

Erreferentzia-estiloko estekek beste kortxete-multzo bat erabiltzen dute; kortxete horien barruan nahi dugun etiketa jar dezakegu, esteka identifikatzeko:

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

Nahi izanez gero, kortxeteak banatzeko zuriunea erabil dezakegu:

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

Gero, dokumentuaren edozein lekutan, gure estekaren etiketa definitu dezakegu, lerroan bertan:

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

Hau da:

estekaren identifikatzailea duten kortxeteak (ezkerreko marjinan koska egin daiteke, zuriune edo tabuladoreekin);
ondoren bi puntu;
gero zuriune (edo tabuladore) bat edo gehiago;
ondoren estekaren URLa;
eta gero, nahi izanez gero, estekaren atributu-titulua, komatxo artean.

Estekaren URLa <> ikurrekin bildu daiteke:

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

Atributu-titulua hurrengo lerroan jar dezakegu eta koska egiteko zuriune edo tabuladore gehigarriak jarri, URL luzeak hobeto ikusteko:

[id]: http://example.com/longish/path/to/resource/here

��� "Optional Title Here"

Esteken definizioak Markdown prozesuan estekak sortzeko bakarrik erabiltzen dira; HTML irteera-dokumentuan kendu egiten dira.

Esteken definizioko izenak letrak, zenbakiak, zuriuneak eta puntuazio-zeinuak izan daitezke (letra larriak eta xeheak ez dira bereizten). Bi atrake hauek, adibidez:

[link text][a]

[link text][A]

baliokideak dira.

Estekaren izena inplizitua laburbideak estekaren izena kentzeko aukera ematen du; kasu horretan, estekaren testua bera izen bezala erabiltzen da. Bi kortxete huts bakarrik erabiliko ditugu; �Google� hitza ggogle.com web guneari lotzeko, hau idatzi besterik ez dugu:

[Google][]

eta gero esteka definitu:

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

Esteken izenek zuriuneak izan ditzaketenez, laburbideek estekaren testuko hitz anitzetan ere funtzionatzen dute:

Visit [Daring Fireball][] for more information.

eta gero esteka definitu:

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

Estekaren definizioak Markdown dokumentuaren edozein lekutan jar daitezke. Normalean erabiltzen diren paragrafoaren ondoren jartzen dira, baina, nahi izanez gero, guztiak dokumentuaren bukaeran jar ditzakezu, orri-oin gisa.

Hona hemen erreferentzia-esteken 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"

Esteken izeneko laburbide inplizitua erabiliz gero, era honetan idatz genezake:

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"

Ambos ejemplos anteriores producir�n el siguiente HTML de salida:

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

Alderatzeko, hona hemen paragrafo bera Markdownen esteken lineako estiloa erabiliz idatzia:

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

Erreferentzia-estiloko estekak ez dira errazago idazten. Baina, erreferentzia-estiloko estekekin iturri-dokumentua askoz irakurterrazagoa da. Aldera itzazu aurreko adibidea: erreferentzia-estiloak erabiliz gero, paragrafoak 81 karaktere ditu; lineako estekekin 176 karaktere; eta HTML gisa 234. HTMLn testu baino etiketa gehiago dago.

Markdownen erreferentzia-estiloko estekekin, iturri-dokumentuak nabigatzailean agertuko den azken dokumentuaren antz gehiago dauka. Metadatuen etiketak paragrafotik kanpo utzita, estekak prosa eten gabe erantsi ahal izango dituzu.

Enfasia

Markdownek asteriskoa (*) eta marratxo baxuak (_) erabiltzen ditu enfasia adierazteko. Testua ikur hauekin biltzen badugu: * edo _ , HTML etiketan bihurtuko da; eta * bikoitza edo '_ ' HTMLko etiketaren bilduko da. Lerro hauek, adibidez:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

hau eragingo dute:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Edozein estilo erabil dezakegu, nahi dugun lekuan; muga bakarra da enfasia irekitzeko eta ixteko karaktere bera erabiltzea.

Enfasia hitz baten erdian erabil daiteke:

un*fucking*believable

Baina * edo _ zuriuneekin biltzen baduzu, asterisko edo marra literal gisa tratatuko da.

Asterisko edo marra literal bat sortzeko, \� erabili behar da:

\*this text is surrounded by literal asterisks\*

Kodea

Kodea adierazteko, parentesi artean bildu: (`). Kodearen aurretik formateatutako bloke bat agertuko da; etiketa horrek paragrafo arrunt batean kodea adierazten du. Honek, adibidez:

Use the `printf()` function.

Hau sortuko du:

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

` karaktere literal bat sartzeko, \ eta gero ` jarri behar dugu:

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

Bestela, nahi izanez gero, ` anitz erabil ditzakezu, irekiera eta itxiera mugatzaile gisa:

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

Aurreko bi adibideek hau sortzeko dute:

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

Kode-etiketarekin, "&" zeinua eta "<" y ">" zeinuak HTMLko entitate gisa kodetzen dira automatikoki; era horretan HTMLko adibide-etiketak jartzea erraza da. Markdownek hau:

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

hau bihurtuko du:

<p>Please don't use any <code>&lt;blink&gt;</code> tags.</p>

Hau idatz dezakegu:

`&#8212;` is the decimal-encoded equivalent of `&mdash;`.

hau sortzeko:

<p><code>&amp;#8212;</code> is the decimal-encoded

equivalent of <code>&amp;mdash;</code>.</p>

Irudiak

Testu-dokumentuen formatuan irudiak jartzeko sintaxi �naturala� sortzea zaila da, noski.

Markdownek, irudietarako, esteken sintaxiaren antzekoa erabiltzen du; bi estilo daude: lineakoa eta erreferentzia.

Lineako irudi-sintaxia honela agertzen da:

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

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

Hau da:

harridura-etiketa bat: !;
gero pare bat kortxete, irudiaren atributuaren testua barruan dutela;
eta ondoren bi parentesi, URLa edo irudiaren bidea barruan dutela, eta, nahi izanez gero, titulu-atributua apostrofe artean.

Erreferentzia-estiloko irudiaren sintaxiak itxura hau dauka:

![Alt text][id]

"id" irudiaren erreferentzia definitu baten identifikazioaren izena da. Irudiaren erreferentziak esteken erreferentzietako sintaxi bera erabiliz zehazten dira:

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

Oraingoz, Markdownek ez dauka irudien neurriak zehazteko sintaxirik; hori garrantzitsua iruditzen bazaizu, HTMLko < img > etiketa arruntak erabil ditzakezu.

Hainbat

Esteka automatikoak

Markdownek laburbide-estiloa dauka URLen eta helbide elektronikoen esteka �automatikoak� sortzeko: URLa edo helbide elektronikoa <> ikurrekin bildu besterik ez duzu. Hala, URLaren edo helbide elektronikoaren benetako testua agertuko da eta esteka klik egiteko modukoa izango da. Hau, adibidez:

<http://example.com/>

Markdownek hau bihurtuko du:

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

Helbide elektronikoen lotura automatikoek antzera funtzionatzen dute. Dena den, Markdownek bihurketa hamaseitarra egiten du, ausaz, helbide elektronikoak spam egiteko biltzen dituzten programei helbidea ezkutatzeko. Hau, adibidez:

<address@example.com>

Markdownek hau bihurtuko du:

<a href="&#x6D;&#x61;i&#x6C;&#x74;&#x6F;:&#x61;&#x64;&#x64;&#x72;&#x65;

&#115;&#115;&#64;&#101;&#120;&#x61;&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;

&#109;">&#x61;&#x64;&#x64;&#x72;&#x65;&#115;&#115;&#64;&#101;&#120;&#x61;

&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;</a>

Nabigatzailean era honetan agertuko da: �address@example.com�.

(Kodetze-trikimailu hori medio, spam-programa asko engainatzen dira, guztiak ez, ordea. Ezer baino hobe da, baina kodetu gabe argitaratutako helbideak spam jasotzen hasiko dira, seguru asko).

Backslash Escapes

Markdownek backlash-ihesak erabiltzeko aukera ematen du Markdownen formatuko sintaxian esanahi berezia izango luketen karaktere literalak sortzeko. Adibidez, hitz bat asterisko literalekin bildu nahi baduzu (HTML etiketarekin beharrean), asteriskoen aurretik backlashak erabil ditzakezu:

\*literal asterisks\*

Markdownek karaktere hauetarako bakclash-ihesak eskaintzen ditu:

\�� backslash (alderantzikako barra)

`�� backtick (azentu kamutsa)

*�� asterisk (asteriskoa)

_�� underscore (azpimarra)

{}� curly braces (giltzak)

[]� square brackets (kortxeteak)

()� parentheses (parentesiak)

#�� hash mark (traola)

.�� dot (puntua)

!�� exclamation mark (harridura)

Laguntza-fitxategien zerrenda
Erakutsi laguntza hizkuntza honetan: English