Convertiți și previzualizați Markdown

Panou de control
Documentație
API

convertește Markdown-ul dvs. în HTML și afișează o previzualizare în timp real, ideal pentru a redacta fișiere README, documentație sau articole

Ce este Markdown?

Markdown este un limbaj de marcare ușor creat de John Gruber în 2004. Permite redactarea de text formatat folosind o sintaxă simplă și lizibilă în stare brută, care este apoi convertită în HTML.

Acest instrument utilizează specificația GFM (GitHub Flavored Markdown), varianta cea mai răspândită, care adaugă suport pentru tabele, casete de bifare, blocuri de cod cu colorare sintactică și linkuri automate.

Previzualizarea din dreapta se actualizează în timp real în timp ce tastați. Butonul Trimite generează codul HTML corespunzător, pe care îl puteți copia sau descărca.

Sintaxa de bază Markdown

Markdown	Rezultat
`# Titlu 1`	Titlu <h1>
`## Titlu 2`	Titlu <h2>
`aldin`	aldin
`cursiv`	cursiv
`cod inline`	`cod inline`
```php ... ```	Bloc de cod PHP
`[text](url)`	Hyperlink
`![alt](url)`	Imagine
`- element`	Listă neordonată
`1. element`	Listă ordonată
`> citat`	Blockquote
`---`	Separator orizontal

Cazuri de utilizare frecvente

README GitHub: redactarea documentației unui proiect open source.
Documentație tehnică: scrierea de ghiduri, wiki-uri sau pagini de documentație (MkDocs, Docusaurus, Hugo).
Articole de blog: majoritatea sistemelor CMS (Jekyll, Ghost, Contentful) acceptă Markdown.
Comentarii și issue-uri: GitHub, GitLab, Jira, Notion și Slack acceptă toate GFM.
E-mailuri formatate: convertirea Markdown în HTML pentru integrarea într-un e-mail HTML.
Note și prezentări: Obsidian, Notion, Marp și Reveal.js utilizează Markdown.

Întrebări frecvente

Care este diferența dintre Markdown standard și GFM?

Markdown standard (CommonMark) acoperă elementele de bază: titluri, liste, linkuri, cod. GFM (GitHub Flavored Markdown) adaugă tabelele, listele de sarcini (- [ ] element), codul delimitat cu limbaj (```php), mențiunile și linkurile automate. Acest instrument utilizează GFM prin intermediul bibliotecii league/commonmark.

HTML-ul generat este sigur?

Da. Convertorul este configurat să elimine etichetele HTML brute (html_input: strip) și să blocheze linkurile nesigure, ceea ce previne atacurile XSS. HTML-ul produs este potrivit pentru integrarea într-o pagină web existentă.

Pot include HTML în Markdown-ul meu?

Din motive de securitate, codul HTML brut inserat în Markdown este eliminat la conversie. Dacă aveți nevoie de o randare HTML personalizată, redactați direct HTML-ul dorit.

Care este dimensiunea maximă a documentului?

Nu există o limită strictă pe partea de server pentru acest instrument. Pentru documente foarte lungi (peste câteva mii de linii), previzualizarea în timp real poate încetini în funcție de browserul dvs.

Exemplu de cerere

curl -X POST https://cdrn.fr/api/v1/tools/markdown-formatter/execute \
  -H "Content-Type: application/json" \
  -d '{"input":"..."}'

Schema de intrare

Câmp	Tip	Obligatoriu	Implicit
`input`	text		–

Puncte de acces

GET https://cdrn.fr/api/v1/tools - listează toate instrumentele disponibile
GET https://cdrn.fr/api/v1/tools/markdown-formatter - obține schema acestui instrument
POST https://cdrn.fr/api/v1/tools/markdown-formatter/execute - execută acest instrument cu un payload JSON