Utilia

HTML į Markdown keitiklis

Konvertuok HTML į Markdown ir Markdown į HTML naršyklėje su GitHub lentelėmis, perbraukimu, užduočių sąrašais ir saugia peržiūra. Nieko neįkeliama.

Konvertavimas

Peržiūra

Peržiūra išvalyta: scenarijai, formos ir įvykių tvarkyklės pašalinti, o nuotoliniai vaizdai niekada neįkeliami.

Kaip konvertuoti HTML į Markdown

  1. Pasirink kryptį: HTML → Markdown arba Markdown → HTML.
  2. Įklijuok kodą į įvesties laukelį arba spustelėk Atidaryti failą, kad įkeltum .html, .htm, .md ar .txt failą iš savo kompiuterio (iki 10 MB).
  3. Pakoreguok parinktis. Konvertuojant HTML → Markdown gali pasirinkti Antraštės stilių, Sąrašo ženklas ir Kodo blokai stilių. Konvertuojant Markdown → HTML pagal numatytuosius nustatymus įjungta Išvalyti HTML (pašalinti scenarijus ir įvykių tvarkykles).
  4. Spustelėk Konvertuoti. Rezultatas atsinaujina ir tau rašant.
  5. Nukopijuok arba atsisiųsk rezultatą. Pakeisti kryptį perkelia rezultatą atgal į įvestį, kad galėtum konvertuoti į kitą pusę ir patikrinti apvalią kelionę.

Peržiūra po rezultatu rodo, kaip atvaizduojamas Markdown, todėl konvertavimą gali patikrinti iš pirmo žvilgsnio.

Ką daro HTML → Markdown konvertavimas

Keitiklis skaito tavo HTML su pačios naršyklės analizatoriumi, inertiniame dokumente: scenarijai nevykdomi, o vaizdai neatsisiunčiami. Tada jis pereina puslapio struktūrą ir kiekvienam elementui parašo Markdown atitikmenį:

  • <h1>–<h6> tampa antraštėmis. ATX (# Pavadinimas) rašo #–######; Setext (pabraukta) 1 ir 2 lygio antraštes pabraukia === ar --- (3–6 lygiai visada naudoja #).
  • <strong> ir <b> tampa **paryškinimu**, <em> ir <i> – _kursyvu_, eilutinis <code> – atvirkštinėmis kabutėmis.
  • Nuorodos tampa [tekstas](url "pavadinimas"), o vaizdai – ![alt](src).
  • Sąrašai naudoja pasirinktą ženklą (-, * ar +); numeruoti sąrašai išsaugo start numerį, o įdėtieji sąrašai įtraukiami.
  • <pre><code> tampa kodo bloku, Aptverti (```) arba Įtraukti (4 tarpai).
  • <blockquote>, <hr> ir eilučių lūžiai taip pat konvertuojami.
  • <script>, <style>, <iframe>, <noscript> ir panašūs elementai pašalinami kartu su turiniu.

Simboliai, kurie kitu atveju būtų skaitomi kaip Markdown sintaksė, pavyzdžiui, * ar # eilutės pradžioje, apsaugomi atgaliniu pasviruoju brūkšniu, kad tekstas liktų pažodinis.

GitHub Flavored Markdown

Pažymėjus GitHub Flavored Markdown (lentelės, ~~perbraukimas~~, užduočių sąrašai):

  • Lentelės tampa vertikaliais brūkšniais atskirtomis lentelėmis su lygiuotais stulpeliais. Antraštė paimama iš <thead> eilutės arba eilutės, sudarytos vien iš <th> langelių; jei jos nėra, pridedama tuščia antraštės eilutė, nes GFM jos reikalauja. Stulpelių lygiavimas skaitomas iš align="right" ar style="text-align: center". Vertikalūs brūkšniai langeliuose apsaugomi kaip \|, eilučių lūžiai tampa <br>, o colspan papildomas tuščiais langeliais. <caption> rašomas kaip pastraipa virš lentelės.
  • <del>, <s> ir <strike> tampa ~~perbraukimu~~.
  • Žymimieji langeliai sąrašo elementų pradžioje tampa užduočių sąrašo elementais: - [x] atlikta, - [ ] daryti.

Markdown neturi atitikmens įdėtoms lentelėms, sujungtoms eilutėms ar langelių stiliui. Lentelė, kurioje yra kita lentelė, paliekama kaip neapdorotas HTML, kurį priima dauguma Markdown atvaizdavimo įrankių. Be GFM parinkties kiekviena lentelė paliekama kaip HTML.

Markdown → HTML

Kita kryptimi Markdown atvaizduojamas su CommonMark atitinkančiu analizatoriumi, o įjungus parinktį – ir su GFM plėtiniais. Rezultatas yra HTML fragmentai, paruošti įklijuoti į TVS, el. laiško šabloną ar tinklalapį. Kai pažymėta Išvalyti HTML (pašalinti scenarijus ir įvykių tvarkykles), Markdown įterptas neapdorotas HTML išvalomas: pašalinamos <script> žymės, onclick atributai ir javascript: nuorodos. Atžymėk ją tik pačio parašytam Markdown.

Dažnai užduodami klausimai

Ar mano HTML siunčiamas į serverį?

Ne. Abi konversijos vyksta tik tavo naršyklėje, o puslapis niekada neįkelia to, ką įklijuoji ar atidarai. Gali saugiai konvertuoti vidinę dokumentaciją ar juodraščius.

Ar peržiūra saugi su nepatikimu HTML?

Taip. Peržiūra visada praleidžiama per DOMPurify: scenarijai, formos, rėmeliai ir įvykių tvarkyklės pašalinami, nuorodos atsidaro naujame skirtuke be prieigos prie šio puslapio, o nuotoliniai vaizdai niekada neįkeliami. Rodomi tik kaip data: URL įterpti vaizdai.

Kodėl kai kurios mano puslapio dalys dingsta?

Markdown aprašo tik turinio struktūrą. Maketo elementai, CSS klasės, įterpti stiliai, formos ir įterpti valdikliai neturi Markdown formos, todėl paliekamas tik jų tekstas. Scenarijai ir stiliai pašalinami visiškai.

Ar galiu konvertuoti visą tinklalapį?

Taip. Įklijuok visą šaltinį, įskaitant <html> ir <head>: konvertuojamas tik <body> turinys. Kad Markdown būtų švaresnis, įklijuok tik straipsnio dalį, be naršymo ir poraštės.

Kokį Markdown variantą naudoja rezultatas?

Rezultatas atitinka CommonMark – standartą, kurį palaiko GitHub, GitLab, Obsidian, dauguma statinių svetainių generatorių ir daug TVS redaktorių. Lentelės, perbraukimas ir užduočių sąrašai atitinka GitHub Flavored Markdown specifikaciją.