Vodič kroz Markdown
Markdown je skup konvencija za pisanje oblikovanoga teksta u običnoj datoteci, a njegova privlačnost je što izvor ostaje čitljiv čak i kada ga ništa ne prikazuje. Sintaksa ispod je grupirana prema onome što pokušavate učiniti, a svaki redak pokazuje HTML koji zapravo proizvodi.
Ti HTML fragmenti nisu ručno tipkani. Svaki je pravi rezultat vlastitoga Markdown konvertera ovoga mjesta, uspoređen s tablicom od strane test skupa u svakom pokretanju — pa ako bi se redak i alat ikada razlikovali, pokretanje bi neuspjelo umjesto da vas strana zavede.
Dijalekt je CommonMark plus GitHub proširenja koja su gotovo univerzalna: tablice, popisi zadataka i precrtavanje. Fusnote, popisi definicija i direktive su namjerno odsutni, jer dokumentiranje sintakse koja tada ništa ne čini u konverteru jedan klik dalje je gore nego što je preskočiti.
Naglašavanje i ugrađeni kod
9Ugrađena sintaksa radi unutar odlomaka, naslova, stavki popisa i ćelija tablica jednako.
| Sintaksa | Što to čini | HTML proizveljen |
|---|---|---|
| *italic* | Kurziv | <p><em>italic</em></p> |
| _italic_ | Kurziv, alternativni oblikIgnoriran unutar riječi, pa snake_case preživi. | <p><em>italic</em></p> |
| **bold** | Podebljani | <p><strong>bold</strong></p> |
| __bold__ | Podebljani, alternativni oblik | <p><strong>bold</strong></p> |
| ***both*** | Podebljani i kurziv zajedno | <p><em><strong>both</strong></em></p> |
| ~~gone~~ | Precrtavanje | <p><del>gone</del></p> |
| `code` | Ugrađeni kod — ništa unutar se ne tumači | <p><code>code</code></p> |
| ``a ` b`` | Ugrađeni kod koji sadrži obrnutu kosu crtuKoristite više obrnutih apostrofa izvan nego što se pojavljuje unutar. | <p><code>a ` b</code></p> |
| \*not italic\* | Doslovno zvjezdica umjesto naglašavanja | <p>*not italic*</p> |
Naslovi
7Oblik heša je onaj koji se koristi; oblik crtice doseže samo dvije razine.
| Sintaksa | Što to čini | HTML proizveljen |
|---|---|---|
| # Heading | Naslikov razine 1 | <h1>Heading</h1> |
| ## Heading | Naslikov razine 2 | <h2>Heading</h2> |
| ### Heading | Naslikov razine 3 | <h3>Heading</h3> |
| ###### Heading | Naslikov razine 6 — najdublje koji postoji | <h6>Heading</h6> |
| Heading ======= | Naslikov razine 1, oblik s crticama | <h1>Heading</h1> |
| Heading ------- | Naslikov razine 2, oblik s crticama | <h2>Heading</h2> |
| ## Heading ## | Zaostale heše su dekoracija i padajuBroj na desnoj strani se ignora; samo onaj sa lijevom postavlja razinu. | <h2>Heading</h2> |
Popisi
7Uvlačite dva razmaka za ugniježđivanje. Prazan redak između stavki čini svaku od njih odlomak.
| Sintaksa | Što to čini | HTML proizveljen |
|---|---|---|
| - one - two | Nabrojana popis | <ul> <li>one</li> <li>two</li> </ul> |
| * one * two | Nabrojana popis, alternativni označitelja | <ul> <li>one</li> <li>two</li> </ul> |
| 1. one 2. two | Brojani popis | <ol> <li>one</li> <li>two</li> </ol> |
| 1. one 1. two | Također nabrojana popis, renumerirana pri prikazivanjuSamo se prvi broj koristi; ostatak mogu biti svi 1. | <ol> <li>one</li> <li>two</li> </ol> |
| - one - nested | Ugniježđeni popis — uvlačite dijete za dva razmaka | <ul> <li>one <ul> <li>nested</li> </ul></li> </ul> |
| - [ ] todo | Nekompletna stavka popisa zadatka | <ul> <li><input type="checkbox" disabled /> todo</li> </ul> |
| - [x] done | Kompletna stavka popisa zadatka | <ul> <li><input type="checkbox" checked disabled /> done</li> </ul> |
Veze i slike
6| Sintaksa | Što to čini | HTML proizveljen |
|---|---|---|
| [text](https://a.co) | Veza | <p><a href="https://a.co">text</a></p> |
| [text](https://a.co "Tip") | Veza s naslovom savjeta | <p><a href="https://a.co" title="Tip">text</a></p> |
| <https://a.co> | Goli URL pretvoren u vezu | <p><a href="https://a.co">https://a.co</a></p> |
| [mail](mailto:[email protected]) | Veza e-pošte | <p><a href="mailto:[email protected]">mail</a></p> |
|  | Slika, s alternativnim tekstom | <p><img src="cat.png" alt="alt" /></p> |
| [x](javascript:alert(1)) | Nesiguran plan — veza pada, tekst ostajejavascript:, data: i vbscript: URL-ovi gube svoju href. | <p>x</p> |
Elementi bloka
9Svaki od njih mora započeti na početku redaka.
| Sintaksa | Što to čini | HTML proizveljen |
|---|---|---|
| > quoted | Blok citata | <blockquote> <p>quoted</p> </blockquote> |
| > > deeper | Ugniježđeni blok citata | <blockquote> <blockquote> <p>deeper</p> </blockquote> </blockquote> |
| ``` code ``` | Ograđeni blok koda | <pre><code>code </code></pre> |
| ```js let a = 1; ``` | Ograđeni blok koda s klasom jezika za isticanje | <pre><code class="language-js">let a = 1; </code></pre> |
| code | Blok koda prema uvlačenju od četiri razmaka | <pre><code>code </code></pre> |
| --- | Vodoravna linija | <hr /> |
| *** | Vodoravna linija, alternativni oblik | <hr /> |
| one two | Prijelom reda unutar odlomkaDva zaostala razmaka. Nevidljivo u većini urednika, što je razlog zašto to tako često neuspijeva. | <p>one<br /> two</p> |
| one two | Prazan redak odvaja odlomke | <p>one</p> <p>two</p> |
Tablice
4Redak ograničnika je ono što čini tablicu. Poravnanje se postavlja dvotačkama u tom redu.
| Sintaksa | Što to čini | HTML proizveljen |
|---|---|---|
| | a | b | | - | - | | 1 | 2 | | Tablica — zaglavlje, redak ograničnika, zatim redovi tijela | |
| | :--- | | Poravnanje u lijevu kolonu, u redu ograničnika | |
| | :---: | | Srednja kolona | |
| | ---: | | Desna kolona |
FAQ
Koja je razlika između * i _ za naglašavanje?
Nema razlike za uobičajene slučajeve — oboje proizvode kurziv, a udvostručavanje bilo kojega proizvodi podebljani tekst. Razlika se pokazuje samo unutar riječi: snake_case_name ostaje nepromijenjen jer donje crte između znakova riječi nisu tretirane kao naglašavanje, dok bi zvjezdice to učinile. To je razlog zašto je oblik zvjezdice sigurnija navika u tehničkom pisanju.
Kako napisati prijelom reda bez početka novoga odlomka?
Završite redak s dva razmaka, što postaje <br />. Umjesto toga, prazan redak započinje novi odlomak. Pravilo od dva razmaka je nevidljivo u većini urednika i je najčešći razlog što se prijelom redaka u Markdown-u ne pojavljuje.
Kako prikazati doslovno zvjezdicu ili donju crtu?
Stavite obrnutu kosu crtu ispred nje: \*nije kurziv\*. Unutar obrnutih apostrofa ništa se ne trebate zaštititi, što je obično bolji odgovor kada je tekst kod.
Trebaju li Markdown tablice vanjskih cijevi?
Ne — vodeće i zaostale cijevi su neobavezne, kao i poravnavanje stupaca u izvoru. Ono što je obavezno je redak ograničnika ispod zaglavlja; bez njega je blok odlomak s crticama.
Je li bilo što što zalijepim u konverter učitano?
Ne. Svaki alat na ovome mjestu se izvršava u vašoj pregledniku, a ova stranica uopće nema skripti — to je statička tablica. Ništa što tipkate nije poslano nikamo, i nema poslužitelja na koji bi se poslalo.