Editor Markdown

Acest editor Markdown online îți arată textul în stânga și rezultatul formatat în dreapta, iar previzualizarea se schimbă la fiecare tastă pe care o apeși. Înțelege sintaxa Markdown folosită pe GitHub, în fișierele README, în wikiuri și în aplicații de notițe precum Obsidian: titluri, liste, liste de sarcini, tabele, cod, citate, linkuri, imagini și note de subsol. Nu ai nevoie de cont și nimic din ce scrii nu este trimis nicăieri.

Cum folosești editorul Markdown online

1. Scrie sau lipește Markdown în câmpul din stânga ori deschide un fișier .md cu butonul de fișier din bara de instrumente. Poți și să tragi un fișier oriunde pe editor.
2. Urmărește previzualizarea din dreapta. Derulare sincronizată ține ambele părți la aceeași porțiune a documentului în timp ce derulezi oricare dintre ele.
3. Formatează textul cu bara de instrumente sau cu comenzi rapide precum Ctrl+B pentru aldin și Ctrl+K pentru link.
4. Copiază rezultatul ca Markdown, ca HTML sau ca text formatat ori descarcă-l ca fișier .md, .pdf, .docx, .html sau .txt.

Editorul se deschide cu un scurt exemplu numit „Notițe de proiect”, care folosește toate elementele obișnuite, ca să vezi sintaxa și rezultatul ei unul lângă altul înainte să scrii propriul text.

Editor Markdown cu previzualizare live

Deasupra editorului sunt trei vizualizări. Alăturată pune textul Markdown și previzualizarea una lângă alta, Editare dă toată lățimea textului, iar Previzualizare arată doar rezultatul, așa că funcționează ca un simplu viewer Markdown pentru un fișier pe care ți l-a trimis cineva. Pe telefon editorul comută între Editare și Previzualizare, pentru că două coloane ar fi prea înguste pentru citit.

Previzualizarea arată textul așa cum îl afișează GitHub: CommonMark cu extensiile GitHub Flavored Markdown (ambele în engleză), care adaugă tabele, liste de sarcini, text tăiat și linkuri automate. Titlurile primesc ancore ca pe GitHub, așa că la ## Plan de lansare duce linkul #plan-de-lansare, iar un clic pe un astfel de link derulează previzualizarea până la titlu. Notele de subsol scrise ca [^1] sunt numerotate în ordinea în care le menționezi prima dată și listate la sfârșit.

Câmpul de text folosește corectorul ortografic al browserului, așa că un cuvânt scris greșit este subliniat în timp ce scrii. Sub editor vezi numărul de cuvinte și de caractere și timpul de citire. Sintaxa Markdown nu intră în numărătoare, așa că dintr-un titlu marcat cu ## se numără doar cuvintele. Ca să numeri și propozițiile și paragrafele, lipește textul în contorul de cuvinte și caractere.

Bara de instrumente și comenzile rapide de la tastatură

Bara de instrumente acoperă tot ce îți trebuie pentru un document obișnuit: Titlu, Aldin, Cursiv, Tăiere cu o linie, Cod inline, Link, Imagine, Citat, Bloc de cod, Listă cu marcatori, Listă numerotată, Listă de sarcini, Tabel și Linie orizontală. Selectează mai întâi un text și butonul îl încadrează cu marcaje; apasă din nou același buton și marcajele dispar. Fără selecție, butonul inserează un scurt text de completat, deja selectat, așa că doar scrii peste el.

Câteva detalii care economisesc timp:

• Titlu trece rândul curent prin #, ##, ### și înapoi la text simplu.
• Link transformă cuvintele selectate în [cuvinte](https://) și selectează partea cu adresa, gata să lipești URL-ul. Dacă selectezi în schimb un URL, acesta devine adresa.
• Butoanele de listă și Citat acționează asupra tuturor rândurilor selectate deodată. Un clic pe Listă numerotată pe o listă cu marcatori o transformă într-o listă numerotată.
• Apasă Enter la sfârșitul unui element de listă și următorul element începe cu marcatorul potrivit. Numerele cresc, o sarcină nouă începe nebifată, iar Enter pe un element gol încheie lista. Tab și Shift+Tab măresc și micșorează indentarea elementelor de listă.
• Orice modificare făcută cu un buton sau cu o comandă rapidă poate fi anulată cu Ctrl+Z.

Toate comenzile rapide sunt listate la Comenzi rapide de la tastatură, sub editor. Pe Mac, comenzile rapide folosesc tasta Command.

Lipește din Word sau Google Docs și obții Markdown

Când lipești text copiat din Word, Google Docs sau de pe o pagină web, editorul transformă formatarea în Markdown în loc să o piardă. Titlurile devin rânduri cu #, textul aldin și cel cursiv primesc asteriscurile, linkurile își păstrează adresele, listele cu marcatori și cele numerotate (inclusiv listele pe mai multe niveluri din Word) devin liste Markdown, iar tabelele devin tabele Markdown cu primul rând ca antet. Este cel mai rapid mod de a muta un document existent într-un README sau într-o pagină wiki.

Dacă voiai doar textul simplu, apasă Folosește textul simplu în nota care apare după lipire sau lipește cu Ctrl+Shift+V. Codul copiat din VS Code sau din alt editor de cod și textul care este deja Markdown se lipesc exact așa cum sunt.

Ghid rapid de sintaxă Markdown

Cea mai folosită sintaxă, pe scurt. Scrie în editor ce vezi în coloana din stânga și vei obține în previzualizare ce vezi în coloana din dreapta.

Scrii	Obții
# Titlu, ## Secțiune, ### Subsecțiune	Titluri de la nivelul 1 la 3 (până la 6 cu ######)
**aldin** și *cursiv*	aldin și cursiv
~~vechi~~	vechi
`cod`	cod cu font monospațiat
[text](https://example.com)	un link
	o imagine
- element sau 1. element	o listă cu marcatori sau numerotată
- [ ] sarcină și - [x] gata	o listă de sarcini cu casete de bifare
> text citat	un citat
trei accente grave pe un rând înainte și după cod	un bloc de cod
--- pe un rând separat	o linie orizontală
text[^1] și [^1]: notă	o notă de subsol

Un tabel Markdown are nevoie de un rând de antet, de un rând separator din cratime și apoi de câte un rând pentru fiecare rând al tabelului, cu celulele despărțite prin |. Două puncte în rândul separator stabilesc alinierea: :-- aliniază la stânga, :-: centrează, iar --: aliniază la dreapta. Butonul Tabel inserează un tabel gata făcut cu trei coloane, de la care poți porni. Celulele nu trebuie să fie aliniate în sursă, dar dacă le aliniezi, tabelul este mai ușor de editat mai târziu.

Markdown acceptă și HTML pentru lucrurile pentru care nu are sintaxă proprie, cum ar fi <kbd>Ctrl</kbd> pentru taste, <sub> și <sup> pentru H₂O și x² sau <details> pentru o secțiune care se deschide la clic. Scripturile, stilurile și formularele sunt eliminate din previzualizare din motive de securitate.

Copiază ca text formatat sau descarcă fișierul

Copiază Markdown copiază sursa, Copiază HTML copiază HTML curat, gata pentru un site sau un CMS, iar Copiază ca text formatat copiază rezultatul formatat. Lipește-l în Google Docs, Word, Outlook sau Gmail, iar titlurile, textul aldin, listele, linkurile și tabelele ajung formatate, fără să rămână vreun simbol Markdown.

Butoanele de la Descarcă salvează documentul ca Markdown, PDF, Word, HTML sau text simplu dintr-un singur clic, cu numele luat din titlul din front matter sau din primul titlu al documentului. Folosesc setări implicite rezonabile: hârtie A4 (Letter în SUA, Canada, Mexic și alte țări unde acesta este formatul standard), margini normale și text de 11 puncte. Ca să alegi dimensiunea paginii, fonturile și marginile, să adaugi un cuprins sau să convertești mai multe fișiere deodată, folosește Mai multe opțiuni de export, care deschide convertorul Markdown cu textul tău deja completat.

Întrebări frecvente

Textul meu este încărcat sau salvat undeva?

Nu. Previzualizarea, conversia și descărcările au loc în browserul tău, iar textul nu este trimis niciodată unui server. Implicit nici nu se salvează nimic, așa că textul dispare când închizi fila. Dacă bifezi Păstrează ciorna în acest browser, textul este salvat în spațiul de stocare al browserului tău după fiecare modificare și revine la următoarea vizită. Pe un calculator folosit de mai multe persoane debifează opțiunea, ceea ce șterge și ciorna salvată.

Cum deschid și vizualizez online un fișier .md?

Apasă butonul de fișier din bara de instrumente sau trage fișierul pe editor, apoi treci la Previzualizare ca să-l citești ca document formatat. Fișierele de până la 20 MB în UTF-8 sau UTF-16 se deschid direct. Imaginile din fișier sunt afișate dacă au o adresă web completă; imaginile stocate lângă fișier pe calculatorul tău nu pot fi încărcate de o pagină web.

Ce variantă de Markdown folosește editorul?

Urmează CommonMark (în engleză), standardul asupra căruia cad de acord majoritatea instrumentelor Markdown, plus extensiile GitHub: tabele, liste de sarcini, text tăiat, linkuri automate și note de subsol. Textul scris pentru GitHub, GitLab, Obsidian, Reddit sau Discord arată la fel și aici, cu excepția funcțiilor pe care aceste servicii le adaugă în plus, cum ar fi mențiunile de utilizatori sau linkurile wiki din Obsidian.

Cum pun Markdown în Google Docs?

Apasă Copiază ca text formatat și lipește în document. Titlurile, listele, linkurile și tabelele își păstrează formatarea. Versiunile recente de Google Docs pot citi și singure Markdown: meniul de editare are o comandă de lipire din Markdown, după ce activezi Markdown în preferințele din meniul de instrumente.

Editorul acceptă diagrame Mermaid sau formule matematice LaTeX?

Încă nu. Un bloc Mermaid este afișat ca un bloc de cod obișnuit, iar formulele scrise ca $...$ rămân text simplu. Tot restul din GitHub Flavored Markdown este acceptat.

Ce este Markdown și cine îl folosește?

Markdown este un mod de a formata text simplu cu câteva simboluri, creat de John Gruber în 2004, astfel încât un document să rămână lizibil chiar înainte de a fi convertit în HTML (mai multe pe Wikipedia, în engleză). Programatorii îl folosesc pentru fișiere README și documentație, scriitorii pentru notițe și ciorne, iar instrumentele de chat AI răspund în Markdown, motiv pentru care răspunsurile lor sunt pline de asteriscuri și diezi când le lipești în altă parte.

Mai multe instrumente pentru text găsești în categoria Text: compară două versiuni ale unui document ca să vezi ce s-a schimbat sau schimbă literele mari și mici ale titlurilor dintr-o singură mișcare. Programatorii găsesc JSON formatter și alte instrumente în categoria Dezvoltatori.