Cum se folosește

Scrie Markdown în editor sau apasă „Încearcă un exemplu” pentru a încărca un document cu tabele și o listă de sarcini.
Urmărește actualizarea previzualizării în timp ce scrii. Comută la „Sursă HTML” pentru a vedea codul generat.
Activează sau dezactivează GitHub Flavored Markdown sau sfârșiturile de linie simple, în funcție de locul unde va fi publicat textul.
Copiază codul HTML într-un CMS sau e-mail sau descarcă rezultatul ca fișier .html sau .md.

Cum funcționează

Markdown este convertit cu marked, un parser open-source utilizat pe scară largă, care respectă specificația CommonMark și, cu opțiunea GFM activată, GitHub Flavored Markdown: tabele pipe cu aliniere pe coloane, liste de sarcini, ~~text tăiat~~ și linkuri automate pentru URL-uri simple. Notele de subsol, formulele matematice și diagramele Mermaid nu fac parte din aceste specificații și sunt afișate ca text simplu.

Markdown poate conține HTML brut, iar acel HTML este transmis neschimbat, la fel ca în majoritatea procesoarelor de Markdown. Pentru siguranța ta, previzualizarea nu este niciodată introdusă în această pagină. Este randată într-un cadru sandbox care nu are permisiunea de a rula scripturi, de a trimite formulare, de a deschide pop-upuri sau de a accesa acest site, iar politica sa de securitate a conținutului blochează scripturile, foile de stil externe, fonturile și cadrele. O etichetă <script> sau un atribut onclick din Markdown este afișat în sursa HTML, dar nu este executat niciodată. Linkurile din previzualizare sunt afișate, dar nu se deschid; copiați URL-ul dacă doriți să deschideți unul.

Previzualizarea folosește o foaie de stil neutră, similară cu cea a procesoarelor obișnuite pentru README; site-ul tău sau GitHub poate stiliza același HTML diferit. HTML-ul copiat este fragmentul brut, fără stiluri; fișierul .html descărcat adaugă o foaie de stil de bază, astfel încât să arate ca previzualizarea. HTML-ul descărcat sau copiat nu este sanitizat, așa că, dacă conține scripturi, acestea vor rula oriunde îl lipiți sau îl deschideți.

Exemple

Verificarea unui README înainte de push

Lipiți README.md pentru a verifica dacă coloanele tabelului se aliniază, lista de sarcini apare ca bife și blocurile de cod sunt delimitate corect, înainte ca fișierul să ajungă pe GitHub.

Scriere pentru un CMS care acceptă HTML

Redactați un articol de blog în Markdown, apoi apăsați „Copiază HTML” și lipiți marcajul <h2>, <p> și <ul> în editorul HTML al CMS-ului.

Întreruperi de rând în stil chat

Textul dintr-o aplicație de chat are liniile separate prin întreruperi de rând simple. Activarea opțiunii „Tratează întreruperile de rând simple ca <br>” păstrează liniile separate, în loc să le unească într-un singur paragraf.

Întrebări frecvente

Este sigur să lipiți Markdown dintr-o sursă necunoscută?

Da, pentru previzualizare. HTML-ul rezultat este afișat într-un cadru sandbox cu scripturile dezactivate, așa că nici măcar o etichetă <script> sau un handler de eveniment din text nu face nimic aici. Fiți atenți unde lipiți HTML-ul exportat, deoarece nu este sanitizat.

De ce nu apar imaginile mele?

Imaginile de pe alte site-uri sunt blocate implicit pentru ca previzualizarea să nu facă cereri de rețea. Activați „Încarcă imaginile de pe alte site-uri” pentru a le afișa. Căile relative, cum ar fi ./docs/screenshot.png, nu pot funcționa deoarece fișierele nu sunt aici.

Suportă note de subsol, matematică sau diagrame?

Nu. Suportă CommonMark și GitHub Flavored Markdown (tabele, liste de sarcini, text tăiat, linkuri automate). Notele de subsol, formulele LaTeX și diagramele Mermaid sunt extensii pe care această previzualizare le lasă ca text simplu.

De ce un singur sfârșit de linie nu începe un rând nou?

În Markdown standard, un singur sfârșit de linie într-un paragraf este tratat ca un spațiu. Termină linia cu două spații, lasă o linie goală sau activează „Tratează sfârșiturile de linie simple ca <br>”.

Confidențialitate

Markdown este convertit în browserul tău și nu este încărcat sau stocat. Previzualizarea nu încarcă nimic de pe internet, cu excepția cazului în care permiți imagini de pe alte site-uri; atunci acele imagini sunt solicitate direct de la gazdele lor.