Utilia

HTML–Markdown konvertáló

Konvertálj HTML-t Markdownra és vissza a böngésződben, GitHub-táblázatokkal, áthúzással, feladatlistákkal és biztonságos előnézettel. Semmi nem töltődik fel.

Konvertálás

Előnézet

Az előnézet meg van tisztítva: a szkripteket, űrlapokat és eseménykezelőket eltávolítjuk, a távoli képeket pedig soha nem töltjük be.

Hogyan konvertálj HTML-t Markdownra

  1. Válaszd ki az irányt: HTML → Markdown vagy Markdown → HTML.
  2. Illeszd be a kódot a bemeneti mezőbe, vagy kattints a Fájl megnyitása gombra egy .html, .htm, .md vagy .txt fájl betöltéséhez a számítógépedről (legfeljebb 10 MB).
  3. Állítsd be az opciókat. A HTML → Markdown irányhoz kiválaszthatod a Címsorok stílusát, a Listajel típusát és a Kódblokkok stílusát. A Markdown → HTML irányban a HTML megtisztítása (szkriptek és eseménykezelők eltávolítása) alapértelmezés szerint be van kapcsolva.
  4. Kattints a Konvertálás gombra. Az eredmény gépelés közben is frissül.
  5. Másold ki vagy töltsd le az eredményt. Az Irány megfordítása visszahelyezi az eredményt a bemenetbe, hogy a másik irányba is átalakíthasd, és ellenőrizhesd az oda-vissza átalakítást.

Az eredmény alatti Előnézet megmutatja, hogyan jelenik meg a Markdown, így egy pillantással ellenőrizheted a konvertálást.

Mit csinál a HTML → Markdown konvertálás

A konvertáló a böngésző saját elemzőjével olvassa be a HTML-t egy inert dokumentumban: a szkriptek nem futnak, a képek nem töltődnek le. Ezután végigjárja az oldal szerkezetét, és minden elemhez megírja a Markdown megfelelőjét:

  • A <h1>–<h6> címsorokká válnak. Az ATX (# Cím) #–###### jelet ír; a Setext (aláhúzott) az 1. és 2. szintű címsorokat === vagy --- jelekkel húzza alá (a 3–6. szint mindig #-et használ).
  • A <strong> és a <b> **félkövér**, az <em> és az <i> _dőlt_, a soron belüli <code> pedig visszaidézőjelek közé kerül.
  • A hivatkozások [szöveg](url "cím"), a képek ![alt](src) alakot kapnak.
  • A listák a választott jelet használják (-, * vagy +); a rendezett listák megtartják a start számot, a beágyazott listák behúzva szerepelnek.
  • A <pre><code> kódblokk lesz, Kerített (```) vagy Behúzott (4 szóköz) formában.
  • A <blockquote>, a <hr> és a sortörések szintén átalakulnak.
  • A <script>, <style>, <iframe>, <noscript> és hasonló elemek a tartalmukkal együtt törlődnek.

Azokat a karaktereket, amelyeket egyébként Markdown-szintaxisként olvasnának, például egy sor elején álló * vagy # jelet, az eszköz fordított perjellel escape-eli, hogy a szöveg szó szerinti maradjon.

GitHub Flavored Markdown

A GitHub Flavored Markdown (táblázatok, ~~áthúzás~~, feladatlisták) bejelölésekor:

  • A táblázatok igazított oszlopú pipe-táblázatokká válnak. A fejléc egy <thead> sorból vagy egy kizárólag <th> cellákból álló sorból származik; ha nincs ilyen, üres fejlécsor kerül hozzá, mert a GFM megköveteli. Az oszlopigazítást az align="right" vagy a style="text-align: center" adja. A cellákban lévő függőleges vonalak \| alakban escape-elődnek, a sortörések <br> elemekké válnak, a colspan pedig üres cellákkal van kitöltve. A <caption> a táblázat feletti bekezdésként íródik ki.
  • A <del>, az <s> és a <strike> ~~áthúzás~~ lesz.
  • A listaelemek elején álló jelölőnégyzetek feladatlista-elemekké válnak: - [x] kész, - [ ] teendő.

A Markdownban nincs megfelelője a beágyazott táblázatoknak, az összevont soroknak vagy a cellastílusoknak. Az a táblázat, amely másik táblázatot tartalmaz, nyers HTML-ként marad meg, amit a legtöbb Markdown-megjelenítő elfogad. A GFM opció nélkül minden táblázat HTML-ként marad meg.

Markdown → HTML

A másik irányban a Markdownt CommonMark-kompatibilis elemző rendereli, bekapcsolt opciónál a GFM-bővítményekkel. A kimenet HTML-részletek, amelyeket CMS-be, e-mail-sablonba vagy weboldalra illeszthetsz. Ha a HTML megtisztítása (szkriptek és eseménykezelők eltávolítása) be van jelölve, a Markdownba ágyazott nyers HTML megtisztul: a <script> címkék, az onclick attribútumok és a javascript: hivatkozások eltűnnek. Csak a saját magad írta Markdownnál kapcsold ki.

Gyakori kérdések

Elküldésre kerül a HTML-em egy szervernek?

Nem. Mindkét konvertálás teljes egészében a böngésződben fut, az oldal soha nem tölti fel, amit beillesztesz vagy megnyitsz. Nyugodtan konvertálhatsz belső dokumentációt vagy piszkozatokat.

Biztonságos az előnézet megbízhatatlan HTML-lel?

Igen. Az Előnézet mindig átmegy a DOMPurify-on: a szkriptek, űrlapok, keretek és eseménykezelők eltávolításra kerülnek, a hivatkozások új lapon nyílnak meg az oldalhoz való hozzáférés nélkül, a távoli képek pedig soha nem töltődnek be. Csak a data: URL-ként beágyazott képek jelennek meg.

Miért tűnnek el az oldalam egyes részei?

A Markdown csak a tartalom szerkezetét írja le. Az elrendezési elemeknek, CSS-osztályoknak, soron belüli stílusoknak, űrlapoknak és beágyazott widgeteknek nincs Markdown-formájuk, ezért csak a szövegük marad meg. A szkriptek és stílusok teljesen törlődnek.

Konvertálhatok egy teljes weboldalt?

Igen. Illeszd be a teljes forrást a <html> és a <head> elemmel együtt: csak a <body> tartalma konvertálódik. Tisztább Markdownért csak a cikk részét illeszd be, a navigáció és a lábléc nélkül.

Milyen Markdown-változatot használ a kimenet?

A kimenet a CommonMarkot követi, amelyet a GitHub, a GitLab, az Obsidian, a legtöbb statikus oldalgenerátor és sok CMS-szerkesztő támogat. A táblázatok, az áthúzás és a feladatlisták a GitHub Flavored Markdown specifikációját követik.