Sări la conținut
Complet local

Convertor de apeluri Markdown

Convertiți blocuri de apeluri și avertismente între sintaxa GitHub, Obsidian, Docusaurus și MkDocs.

Intrare
Ieșire

Convertor de apeluri Markdown

Blocurile de apel—casetele "Notă", "Sfat" sau "Avertisment" din fișierele README și pe site-urile de documentație—sunt scrise diferit pe fiecare platformă. GitHub folosește alerte în citate ca `> [!NOTE]`, Obsidian extinde acea sintaxă cu titluri personalizate și săgeți pliabile, Docusaurus încadrează conținutul în garduri `:::tip` și MkDocs (și Material pentru MkDocs) folosește blocuri cu indentare `!!! note` cu `???` pentru cele reductibile. Mutarea documentației între instrumente înseamnă de obicei rescrierea fiecărui apel manual—acest instrument le convertește automat.

Alegeti o notație sursă și țintă din panoul opțiuni, apoi lipiți conținut scris în formatul sursă. Fiecare apel recunoscut este analizat și rescris în sintaxa țintă; orice altceva din intrare—paragrafe, titluri, alt Markdown—trece neschimbat. "Păstrați titlul personalizat al blocului" păstrează un titlu cum ar fi apelul `> [!info] Heads up` al Obsidian atunci când ținta o acceptă (GitHub nu are sintaxă titlu, deci un titlu păstrat devine o primă linie bold în bloc). "Păstrați starea pliabilă/reductibilă" păstrează marcatorii de pliare `+`/`-` ai Obsidian și sintaxa `???`/`???+` a MkDocs unde ținta are un echivalent; GitHub și Docusaurus nu au apeluri reductibile, deci comuta nu are efect acolo. "Normalizați tipul de bloc" mapează numere mai puțin frecvente (important, precauție, succes, întrebare…) la cei cinci tipuri pe care le împărtășesc toate formatele: notă, sfat, avertisment, pericol și informație.

Corpul fiecărui apel este păstrat exact așa cum este scris, inclusiv liste imbricate, formatare inline, linkuri și blocuri de cod delimitate—acestea sunt doar linii obișnuite în bloc. Apeluri multiple într-un document se convertesc într-o singură trecere, iar terminațiile de linie Windows și Unix sunt tratate la fel.

Totul se execută local în browserul dvs.; documentația dvs. nu este niciodată încărcată nicăieri. Copiați rezultatul, descărcați-l ca fișier .txt sau trimiteți rezultatul înapoi la intrare pentru a încadena o altă conversie.

FAQ

Ce tipuri de apeluri recunoaște?
Orice nume de tip în sintaxa sursă—notă, sfat, avertisment, pericol, informație și alte specifice platformei cum ar fi important sau faq. Activați "Normalizați tipul de bloc" pentru a mapa numerele mai puțin frecvente la cei cinci tipuri pe care le au toate formatele.
Ce se întâmplă cu un titlu personalizat atunci când formatul țintă nu are?
Alertele GitHub nu au sintaxă titlu, deci un titlu păstrat este adăugat ca primă linie bold în bloc în loc să fie eliminat.
Apelurile reductibile sunt acceptate?
Da, între Obsidian ("+"/"-" după tip) și MkDocs ("???"/"???+"). GitHub și Docusaurus nu au sintaxă reductibilă, deci starea este eliminată la conversia la oricare dintre ele.
Liste și blocuri de cod din interior unui apel supraviețuiesc conversiei?
Da. Totul din corpul unui apel este păstrat exact așa cum este—liste imbricate, formatare inline și blocuri de cod delimitate incluse.
Documentul dvs. este încărcat undeva?
Nu. Conversia se execută integral în browserul dvs.—textul dvs. nu pleacă niciodată de pe dispozitivul dvs.