Fișă de referință Markdown
Markdown este un set de convenții pentru scrierea textului formatat într-un fișier simplu, iar atractivitatea sa este că sursa rămâne citibilă chiar și atunci când nimic nu o randează. Sintaxa de mai jos este grupată după ceea ce încerci să faci, și fiecare rând arată exact ce HTML produce.
Aceste fragmente HTML nu sunt scrise manual. Fiecare dintre ele este rezultatul real al converterului Markdown al acestui site, comparat cu tabelul de către suitele de teste la fiecare compilare — deci dacă o rând și instrumentul ar fi fost în dezacord vreodată, compilarea ar fi eșuat în loc să te înșele.
Dialectul este CommonMark plus extensiile GitHub care sunt aproape universale: tabele, liste de activități și tăiere text. Notele de subsol, listele de definiții și directivele lipsesc deliberat, deoarece documentarea unei sintaxe care apoi nu face nimic în convertorul care este la un clic distanță este mai rau decât să o omit.
Enfază și cod inline
9Sintaxa inline funcționează în paragrafe, titluri, elemente de listă și celule de tabel la fel.
| Sintaxă | Ce face | HTML produs |
|---|---|---|
| *italic* | Italic | <p><em>italic</em></p> |
| _italic_ | Italic, formă alternativăIgnorate în interiorul unui cuvânt, deci snake_case supraviețuiește. | <p><em>italic</em></p> |
| **bold** | Bold | <p><strong>bold</strong></p> |
| __bold__ | Bold, formă alternativă | <p><strong>bold</strong></p> |
| ***both*** | Bold și italic laolaltă | <p><em><strong>both</strong></em></p> |
| ~~gone~~ | Tăiere text | <p><del>gone</del></p> |
| `code` | Cod inline — nimic în interiorul nu este interpretat | <p><code>code</code></p> |
| ``a ` b`` | Cod inline care conține o ghilimă inversăFolosește mai multe ghilimele inversate în exterior decât apar în interior. | <p><code>a ` b</code></p> |
| \*not italic\* | Un asterisc literal în loc de enfază | <p>*not italic*</p> |
Titluri
7Forma cu hash este cea pe care trebuie s-o folosești; forma cu subliniere ajunge doar la două niveluri.
| Sintaxă | Ce face | HTML produs |
|---|---|---|
| # Heading | Titlu de nivel 1 | <h1>Heading</h1> |
| ## Heading | Titlu de nivel 2 | <h2>Heading</h2> |
| ### Heading | Titlu de nivel 3 | <h3>Heading</h3> |
| ###### Heading | Titlu de nivel 6 — cel mai adânc care există | <h6>Heading</h6> |
| Heading ======= | Titlu de nivel 1, formă sublinied | <h1>Heading</h1> |
| Heading ------- | Titlu de nivel 2, formă sublinied | <h2>Heading</h2> |
| ## Heading ## | Hash-urile din coadă sunt decorare și sunt scăzuteNumărul din dreapta este ignorat; doar cel din stânga stabilește nivelul. | <h2>Heading</h2> |
Liste
7Indentează cu două spații pentru imbricare. O linie goală între articole face fiecare una paragraf.
| Sintaxă | Ce face | HTML produs |
|---|---|---|
| - one - two | Listă cu puncte | <ul> <li>one</li> <li>two</li> </ul> |
| * one * two | Listă cu puncte, marcator alternativ | <ul> <li>one</li> <li>two</li> </ul> |
| 1. one 2. two | Listă numerotată | <ol> <li>one</li> <li>two</li> </ol> |
| 1. one 1. two | De asemenea, o listă numerotată, renumerotată la renderDoar primul număr este folosit; restul pot fi toți 1. | <ol> <li>one</li> <li>two</li> </ol> |
| - one - nested | Listă imbricată — indentează copilul cu două spații | <ul> <li>one <ul> <li>nested</li> </ul></li> </ul> |
| - [ ] todo | Articol din lista de activități necontrolat | <ul> <li><input type="checkbox" disabled /> todo</li> </ul> |
| - [x] done | Articol din lista de activități controlat | <ul> <li><input type="checkbox" checked disabled /> done</li> </ul> |
Linkuri și imagini
6| Sintaxă | Ce face | HTML produs |
|---|---|---|
| [text](https://a.co) | Link | <p><a href="https://a.co">text</a></p> |
| [text](https://a.co "Tip") | Link cu titlu tooltip | <p><a href="https://a.co" title="Tip">text</a></p> |
| <https://a.co> | URL gol transformat într-un link | <p><a href="https://a.co">https://a.co</a></p> |
| [mail](mailto:a@b.co) | Link pentru email | <p><a href="mailto:a@b.co">mail</a></p> |
|  | Imagine, cu text alternativ | <p><img src="cat.png" alt="alt" /></p> |
| [x](javascript:alert(1)) | Schemă nesigură — linkul este scăzut, textul rămânejavascript:, data: și vbscript: URL-uri-și pierd href. | <p>x</p> |
Elemente de bloc
9Fiecare dintre acestea trebuie să înceapă la începutul unei linii.
| Sintaxă | Ce face | HTML produs |
|---|---|---|
| > quoted | Citare bloc | <blockquote> <p>quoted</p> </blockquote> |
| > > deeper | Citare bloc imbricată | <blockquote> <blockquote> <p>deeper</p> </blockquote> </blockquote> |
| ``` code ``` | Bloc de cod gardurat | <pre><code>code </code></pre> |
| ```js let a = 1; ``` | Bloc de cod gardurat cu o clasă de limbă pentru evidențiere | <pre><code class="language-js">let a = 1; </code></pre> |
| code | Bloc de cod prin indentare cu patru spații | <pre><code>code </code></pre> |
| --- | Regulă orizontală | <hr /> |
| *** | Regulă orizontală, formă alternativă | <hr /> |
| one two | Întrerupere de linie în interiorul unui paragrafDouă spații finales. Invizibilă în majoritatea editorilor, de aceea adesea eșuează. | <p>one<br /> two</p> |
| one two | O linie goală separă paragrafe | <p>one</p> <p>two</p> |
Tabele
4Rândul delimitator este ceea ce o face tabel. Alinierea este stabilită prin două puncte în acel rând.
| Sintaxă | Ce face | HTML produs |
|---|---|---|
| | a | b | | - | - | | 1 | 2 | | Tabel — antet, rând delimitator, apoi rânduri de corp | |
| | :--- | | Aliniază stânga coloană, în rândul delimitator | |
| | :---: | | Centre coloană | |
| | ---: | | Aliniază dreapta coloană |