Markdown explicat în 5 minute

Probabil ai folosit Markdown fără să știi. Ai tastat vreodată **bold** într-un mesaj Slack? Ai scris un README pe GitHub? Ai formatat o postare pe Reddit? Acela este Markdown.

Markdown este o modalitate ușoară de a formata text simplu folosind simboluri simple. În loc să faci clic pe butoane de bara de instrumente pentru bold, italic, titluri și liste, tastezi câteva caractere care indică formatarea dorită. A fost creat în 2004 de John Gruber și Aaron Swartz și a devenit de atunci limbajul implicit de formatare pentru dezvoltatori, scriitori și oricine lucrează cu text pe web.

De ce există Markdown

Înainte de Markdown, formatarea textului pentru web însemna scrierea de HTML. Pentru a îngroșa un cuvânt, tastai <strong>bold</strong>. Pentru a crea o listă, aveai nevoie de <ul><li>element</li></ul>. HTML este puternic, dar verbose și greu de citit în forma sa brută.

Markdown rezolvă aceasta prin furnizarea unui prescurtat lizibil de om. Textul brut este ușor de citit chiar înainte de a fi randat. Rezultatul formatat este curat și profesional. Obții ce e mai bun din ambele lumi: text sursă lizibil și rezultat rafinat.

Sintaxa esențială

Iată tot ce trebuie să știi pentru a începe să folosești Markdown productiv.

Titluri

Folosește simboluri diez (#) pentru a crea titluri. Mai multe dieze înseamnă titluri mai mici.

# Titlu 1 (cel mai mare)
## Titlu 2
### Titlu 3
#### Titlu 4

Bold și italic

Înconjoară textul cu asteriscuri sau liniuțe de subliniere:

**text bold**
*text italic*
***bold și italic***

Liste

Listele neordonate folosesc liniuțe, asteriscuri sau semnul plus. Listele ordonate folosesc numere.

- Primul element
- Al doilea element
- Al treilea element

1. Primul pas
2. Al doilea pas
3. Al treilea pas

Linkuri

Paranteze pătrate pentru text, paranteze rotunde pentru URL:

[Fă clic aici](https://example.com)

Imagini

Ca linkurile, dar cu un semn de exclamare în față:

![Text alternativ](url-imagine.jpg)

Citate

Folosește simbolul mai mare decât:

> Acesta este un citat. Va fi indentat și stilizat diferit.

Cod

Backtick-uri pentru cod inline, triple backtick-uri pentru blocuri de cod:

Folosește funcția `print()` pentru a afișa text.

Pentru blocuri de cod pe mai multe rânduri, folosește triple backtick-uri cu un identificator opțional de limbă:

```python
def salut():
    print("Salut, lume!")
```

Linii orizontale

Trei sau mai multe liniuțe, asteriscuri sau liniuțe de subliniere:

---

Tabele

Folosește bare verticale și liniuțe:

| Nume | Rol | Locație |
| --- | --- | --- |
| Alice | Developer | Berlin |
| Bob | Designer | Londra |

Unde se folosește Markdown

Markdown este peste tot:

Dezvoltare software

• GitHub, GitLab, Bitbucket: README-urile, problemele, cererile de pull și documentația sunt toate scrise în Markdown.
• Stack Overflow: Întrebările și răspunsurile folosesc formatare Markdown.
• Documentație de cod: Multe generatoare de documentație (Docusaurus, MkDocs, Jekyll) folosesc Markdown ca format sursă.

Comunicare

• Slack: Suportă un subset de Markdown pentru formatarea mesajelor.
• Discord: Folosește Markdown pentru bold, italic, blocuri de cod și altele.
• Reddit: Postările și comentariile sunt formatate cu Markdown.

Scriere și publicare

• Bloguri: Multe generatoare de site-uri statice folosesc fișiere Markdown ca surse de conținut.
• Cărți: Mai multe instrumente de publicare acceptă manuscrise în Markdown.
• Notițe: Aplicații precum Obsidian, Notion, Bear și Typora sunt construite în jurul Markdown.

Documentație

• Documentație tehnică: Documentația API, ghidurile utilizatorilor și wiki-urile folosesc frecvent Markdown.
• Baze de cunoștințe interne: Multe echipe folosesc wiki-uri bazate pe Markdown.

Variantele Markdown

Un lucru important de știut: există diferite „variante" de Markdown. Sintaxa de bază este aceeași peste tot, dar unele platforme adaugă extensii:

Diferențele sunt în mare parte în funcționalitățile avansate. Elementele de bază (titluri, bold, italic, liste, linkuri, imagini, cod) funcționează la fel peste tot.

Greșeli frecvente

Uitarea rândurilor goale

Markdown necesită un rând gol înainte și după multe elemente. Un titlu are nevoie de un rând gol înainte de el. O listă are nevoie de un rând gol înainte și după. Uitarea acestor rânduri goale este cea mai frecventă sursă de probleme de randare.

Markeri inconsecvenți pentru liste

Amestecarea -, * și + în aceeași listă poate cauza randare neașteptată. Alege unul și menține-l.

Spații după simboluri

Unele procesoare Markdown necesită un spațiu după # în titluri și după - în liste. Include întotdeauna spațiul pentru siguranță.

# Titlu corect
#Titlu incorect

- Element de listă corect
-Element de listă incorect

De ce merită să înveți Markdown

Markdown durează cinci minute să fie învățat și economisește ore în timp. Odată ce îl cunoști, poți:

• Scrie documentație care se randează frumos pe GitHub
• Formata mesaje în Slack și Discord fără a atinge mouse-ul
• Lua notițe structurate portabile între aplicații
• Crea postări de blog și conținut web din fișiere text simplu
• Colabora la documente bazate pe text fără probleme de compatibilitate a formatelor

Raportul investiție-câștig este unul dintre cele mai bune din întreaga lume tehnologică.

Începe să scrii în Markdown chiar acum:

• Scrie și previzualizează Markdown
• Instrument de previzualizare Markdown

Gratuit, în browser, cu previzualizare în timp real pe măsură ce tastezi.