Utilia
Kategoritë ▾
Gjuha: sq ▾

Konvertuesi HTML në Markdown

Konverto HTML në Markdown dhe Markdown në HTML në shfletuesin tënd, me tabela GitHub, lista detyrash dhe pamje paraprake të sigurt. Asgjë nuk ngarkohet.

Konvertimi

Pamje paraprake

Pamja paraprake është e pastruar: skriptet, formularët dhe trajtuesit e ngjarjeve hiqen dhe imazhet e largëta nuk ngarkohen kurrë.

Si ta konvertosh HTML-në në Markdown

  1. Zgjidh drejtimin: HTML → Markdown ose Markdown → HTML.
  2. Ngjit kodin në kutinë e hyrjes, ose kliko Hap një skedar për të ngarkuar një skedar .html, .htm, .md ose .txt nga kompjuteri yt (deri në 10 MB).
  3. Rregullo opsionet. Për HTML → Markdown mund të zgjedhësh stilin e Titujve, Shenjën e listës dhe stilin e Blloqeve të kodit. Për Markdown → HTML, Pastro HTML-në (hiq skriptet dhe trajtuesit e ngjarjeve) është i aktivizuar si parazgjedhje.
  4. Kliko Konverto. Rezultati përditësohet edhe ndërsa shkruan.
  5. Kopjo ose shkarko rezultatin. Ndërro drejtimin e kthen rezultatin në hyrje, që ta konvertosh në drejtimin e kundërt dhe të kontrollosh kalimin vajtje-ardhje.

Pamja paraprake nën rezultat tregon si vizatohet Markdown, ndaj mund ta kontrollosh konvertimin me një shikim.

Çfarë bën konvertimi HTML → Markdown

Konvertuesi e lexon HTML-në me analizuesin e vetë shfletuesit, në një dokument inert: skriptet nuk ekzekutohen dhe imazhet nuk shkarkohen. Pastaj kalon strukturën e faqes dhe shkruan ekuivalentin Markdown të çdo elementi:

  • <h1> deri <h6> bëhen tituj. ATX (# Titulli) shkruan # deri ######; Setext (me nënvizim) nënvizon titujt e nivelit 1 dhe 2 me === ose --- (nivelet 3 deri 6 përdorin gjithmonë #).
  • <strong> dhe <b> bëhen **të trasha**, <em> dhe <i> bëhen _të pjerrëta_, <code> brenda rreshtit bëhet me apostrofa të prapme.
  • Lidhjet bëhen [teksti](url "titulli") dhe imazhet bëhen ![alt](src).
  • Listat përdorin shenjën e zgjedhur (-, * ose +); listat e renditura ruajnë numrin start, dhe listat e folezuara shtyhen.
  • <pre><code> bëhet bllok kodi, Me gardh (```) ose Me shtyrje (4 hapësira).
  • <blockquote>, <hr> dhe ndarjet e rreshtave konvertohen gjithashtu.
  • <script>, <style>, <iframe>, <noscript> dhe elemente të ngjashëm hiqen bashkë me përmbajtjen.

Karakteret që përndryshe do të lexoheshin si sintaksë Markdown, si një * ose një # në fillim të rreshtit, shkruhen me një prapakose që teksti të mbetet i drejtpërdrejtë.

GitHub Flavored Markdown

Me GitHub Flavored Markdown (tabela, ~~të hequra me vijë~~, lista detyrash) të shënuar:

  • Tabelat bëhen tabela me vija vertikale dhe kolona të rreshtuara. Koka vjen nga një rresht <thead> ose një rresht vetëm me qeliza <th>; nëse nuk ka, shtohet një rresht koke bosh, sepse GFM e kërkon. Rreshtimi i kolonave lexohet nga align="right" ose style="text-align: center". Vijat vertikale brenda qelizave kodohen si \|, ndarjet e rreshtave bëhen <br>, dhe një colspan plotësohet me qeliza bosh. Një <caption> shkruhet si paragraf mbi tabelë.
  • <del>, <s> dhe <strike> bëhen ~~të hequra me vijë~~.
  • Kutitë e zgjedhjes në fillim të elementeve të listës bëhen elemente të listës së detyrave: - [x] bërë, - [ ] për t’u bërë.

Markdown nuk ka ekuivalent për tabela të folezuara, rreshta të bashkuar ose stilim qelizash. Një tabelë që përmban një tabelë tjetër mbahet si HTML i papërpunuar, që pranohet nga shumica e vizatuesve Markdown. Pa opsionin GFM, çdo tabelë mbahet si HTML.

Markdown → HTML

Në drejtimin tjetër, Markdown vizatohet me një analizues që përputhet me CommonMark, me shtesat GFM kur opsioni është i aktivizuar. Dalja janë fragmente HTML, gati për t’u ngjitur në një CMS, një shabllon email-i ose një faqe web. Kur Pastro HTML-në (hiq skriptet dhe trajtuesit e ngjarjeve) është i shënuar, HTML-ja e papërpunuar e ngulitur në Markdown pastrohet: etiketat <script>, atributet onclick dhe lidhjet javascript: hiqen. Hiq shenjën vetëm për Markdown që e ke shkruar vetë.

Pyetje të shpeshta

A dërgohet HTML-ja ime në një server?

Jo. Të dyja konvertimet ekzekutohen tërësisht në shfletuesin tënd, dhe faqja nuk ngarkon kurrë çfarë ngjit ose hap. Mund të konvertosh pa rrezik dokumentacion të brendshëm ose drafte.

A është pamja paraprake e sigurt me HTML të panjohur?

Po. Pamja paraprake kalon gjithmonë përmes DOMPurify: skriptet, formularët, kornizat dhe trajtuesit e ngjarjeve hiqen, lidhjet hapen në skedë të re pa akses te kjo faqe, dhe imazhet e largëta nuk ngarkohen kurrë. Shfaqen vetëm imazhet e ngulitura si URL data:.

Pse disa pjesë të faqes sime zhduken?

Markdown përshkruan vetëm strukturën e përmbajtjes. Elementet e paraqitjes, klasat CSS, stilet brenda elementit, formularët dhe widget-et e ngulitura nuk kanë formë Markdown, ndaj mbahet vetëm teksti i tyre. Skriptet dhe stilet hiqen plotësisht.

A mund të konvertoj një faqe të tërë web?

Po. Ngjit burimin e plotë, me <html> dhe <head>: konvertohet vetëm përmbajtja e <body>. Për Markdown më të pastër, ngjit vetëm pjesën e artikullit dhe jo navigimin e fundin e faqes.

Cilin variant të Markdown përdor dalja?

Dalja ndjek CommonMark, standardin e mbështetur nga GitHub, GitLab, Obsidian, shumica e gjeneratorëve të sajteve statike dhe shumë redaktorë CMS. Tabelat, të hequrat me vijë dhe listat e detyrave ndjekin specifikimin GitHub Flavored Markdown.

Mjete të ngjashme