Tahák na Markdown
Markdown je sada konvencí pro psaní formátovaného textu v prostém souboru a jeho přitažlivostí je, že zdroj zůstane čitelný, i když jej nic nevykresluje. Syntaxe níže je seskupena podle toho, co se pokoušíte dělat, a každý řádek ukazuje HTML, které skutečně produkuje.
Tyto fragmenty HTML nejsou zadávány ručně. Každý je skutečným výstupem vlastního konvertoru Markdown této stránky, porovnaného s tabulkou testem na každém sestavení — takže pokud by se řádek a nástroj někdy neshodly, sestavení by selhalo místo toho, aby vás stránka klamala.
Dialekt je CommonMark plus rozšíření GitHub, která jsou téměř univerzální: tabulky, seznamy úkolů a přeškrtnutí. Poznámky pod čarou, definice a direktivy záměrně chybějí, protože zdokumentování syntaxe, která poté v převaděči nefunguje jedním kliknutím, je horší než její vynechání.
Zdůraznění a vložený kód
9Vložená syntaxe funguje uvnitř odstavců, nadpisů, položek seznamu a buněk tabulky.
| Syntaxe | Co to dělá | HTML vytvořeno |
|---|---|---|
| *italic* | Kurzíva | <p><em>italic</em></p> |
| _italic_ | Kurzíva, alternativní formaIgnorováno uvnitř slova, takže snake_case přežívá. | <p><em>italic</em></p> |
| **bold** | Tučnětí | <p><strong>bold</strong></p> |
| __bold__ | Tučnětí, alternativní forma | <p><strong>bold</strong></p> |
| ***both*** | Tučnětí a kurzíva dohromady | <p><em><strong>both</strong></em></p> |
| ~~gone~~ | Přeškrtnutí | <p><del>gone</del></p> |
| `code` | Vložený kód — nic v něm není interpretováno | <p><code>code</code></p> |
| ``a ` b`` | Vložený kód obsahující zpětné akutkoMimo více zpětných lísků než se jeví uvnitř. | <p><code>a ` b</code></p> |
| \*not italic\* | Doslova hvězdička místo zdůraznění | <p>*not italic*</p> |
Nadpisy
7Formulář hash je ten, který se má použít; formulář podtržení pouze dosáhne dvou úrovní.
| Syntaxe | Co to dělá | HTML vytvořeno |
|---|---|---|
| # Heading | Nadpis úrovně 1 | <h1>Heading</h1> |
| ## Heading | Nadpis úrovně 2 | <h2>Heading</h2> |
| ### Heading | Nadpis úrovně 3 | <h3>Heading</h3> |
| ###### Heading | Nadpis úrovně 6 — nejhlubší je zde | <h6>Heading</h6> |
| Heading ======= | Nadpis úrovně 1, forma podtržená | <h1>Heading</h1> |
| Heading ------- | Nadpis úrovně 2, forma podtržená | <h2>Heading</h2> |
| ## Heading ## | Koncová hash jsou dekorace a jsou vynechánaPočet na pravé straně je ignorován; pouze levá nastavuje úroveň. | <h2>Heading</h2> |
Seznamy
7Odsazení o dva mezery do hnízdě. Prázdný řádek mezi položkami dělá každou z nich odstavcem.
| Syntaxe | Co to dělá | HTML vytvořeno |
|---|---|---|
| - one - two | Seznam s odrážkami | <ul> <li>one</li> <li>two</li> </ul> |
| * one * two | Seznam s odrážkami, alternativní značka | <ul> <li>one</li> <li>two</li> </ul> |
| 1. one 2. two | Číslovaný seznam | <ol> <li>one</li> <li>two</li> </ol> |
| 1. one 1. two | Také očíslovaný seznam, přečíslovaný na vykresleníPouze první číslo se používá; zbytek je všechny 1. | <ol> <li>one</li> <li>two</li> </ol> |
| - one - nested | Vnořený seznam — odsaďte dítě o dvě mezery | <ul> <li>one <ul> <li>nested</li> </ul></li> </ul> |
| - [ ] todo | Nezaškrtnutá položka seznamu úkolů | <ul> <li><input type="checkbox" disabled /> todo</li> </ul> |
| - [x] done | Zaškrtnutá položka seznamu úkolů | <ul> <li><input type="checkbox" checked disabled /> done</li> </ul> |
Odkazů a obrázků
6| Syntaxe | Co to dělá | HTML vytvořeno |
|---|---|---|
| [text](https://a.co) | Odkaz | <p><a href="https://a.co">text</a></p> |
| [text](https://a.co "Tip") | Odkaz s titulkem nápovědy | <p><a href="https://a.co" title="Tip">text</a></p> |
| <https://a.co> | Holá URL převedena na odkaz | <p><a href="https://a.co">https://a.co</a></p> |
| [mail](mailto:a@b.co) | Odkaz e-mailu | <p><a href="mailto:a@b.co">mail</a></p> |
|  | Obrázek, s alt textem | <p><img src="cat.png" alt="alt" /></p> |
| [x](javascript:alert(1)) | Nezabezpečené schéma — odkaz se ztrácí, text zůstávájavascript:, data: a vbscript: adresy URL ztratí jejich href. | <p>x</p> |
Prvky bloku
9Každý z nich musí začít na začátku řádku.
| Syntaxe | Co to dělá | HTML vytvořeno |
|---|---|---|
| > quoted | Citace | <blockquote> <p>quoted</p> </blockquote> |
| > > deeper | Vnořená citace | <blockquote> <blockquote> <p>deeper</p> </blockquote> </blockquote> |
| ``` code ``` | Ohraničený blok kódu | <pre><code>code </code></pre> |
| ```js let a = 1; ``` | Ohraničený blok kódu s třídou jazyka pro zvýraznění | <pre><code class="language-js">let a = 1; </code></pre> |
| code | Blok kódu čtyřmístným odsazením | <pre><code>code </code></pre> |
| --- | Vodorovné pravidlo | <hr /> |
| *** | Vodorovné pravidlo, alternativní forma | <hr /> |
| one two | Přestávka řádku uvnitř odstavceDva koncové mezery. Neviditelné v nejvíce editorech, což je důvod, proč tak často selhává. | <p>one<br /> two</p> |
| one two | Prázdný řádek odděluje odstavce | <p>one</p> <p>two</p> |
Tabulky
4Řádek oddělovače je to, co z něho dělá tabulku. Zarovnání je nastaveno symbolů v tom řádku.
| Syntaxe | Co to dělá | HTML vytvořeno |
|---|---|---|
| | a | b | | - | - | | 1 | 2 | | Tabulka — záhlaví, řádek oddělovače, poté řádky těla | |
| | :--- | | Zarovnání sloupce doleva v řádku oddělovače | |
| | :---: | | Střed sloupce | |
| | ---: | | Zarovnání sloupce doprava |