Teknobench

Konvertitur HTML għal Markdown

Ikkonverti HTML għal Markdown u Markdown għal HTML fil-brawżer tiegħek, b’tabelli GitHub, strikethrough, listi ta’ kompiti u previżjoni sigura.

Konverżjoni

Previżjoni

Il-previżjoni hija mnaddfa: scripts, formoli u event handlers jitneħħew u immaġini mill-bogħod qatt ma jitgħabbew.

Kif tikkonverti HTML għal Markdown

  1. Agħżel id-direzzjoni: HTML → Markdown jew Markdown → HTML.
  2. Waħħal il-kodiċi tiegħek fil-kaxxa tad-dħul, jew ikklikkja Iftaħ fajl biex tiftaħ fajl .html, .htm, .md jew .txt mill-kompjuter tiegħek (sa 10 MB).
  3. Aġġusta l-għażliet. Għal HTML → Markdown tista’ tagħżel l-istil tal-Intestaturi, il-Marka tal-lista u l-istil tal-Blokki tal-kodiċi. Għal Markdown → HTML, Naddaf l-HTML (neħħi scripts u event handlers) huwa attiv awtomatikament.
  4. Ikklikkja Ikkonverti. Ir-riżultat jiġi aġġornat ukoll waqt li tikteb.
  5. Ikkopja jew niżżel ir-riżultat. Aqleb id-direzzjoni iċċaqlaq ir-riżultat lura fl-input biex tkun tista’ tikkonvertih fid-direzzjoni l-oħra u tiċċekkja r-round trip.

Il-Previżjoni taħt ir-riżultat turi kif jitfassal il-Markdown, biex tiċċekkja l-konverżjoni b’ħarsa.

X’jagħmel il-konverżjoni HTML → Markdown

Il-konvertitur jaqra l-HTML tiegħek bil-parser proprju tal-brawżer, f’dokument inert: scripts ma jaħdmux u l-immaġini ma jitniżżlux. Imbagħad jimxi mal-istruttura tal-paġna u jikteb l-ekwivalent Markdown ta’ kull element:

  • <h1> sa <h6> isiru intestaturi. ATX (# Titlu) jikteb # sa ######; Setext (bi sottolinjar) isottolinja l-intestaturi tal-livell 1 u 2 b’=== jew --- (il-livelli 3 sa 6 dejjem jużaw #).
  • <strong> u <b> isiru **bi grassett**, <em> u <i> isiru _korsiv_, <code> inline isir backticks.
  • Il-links isiru [test](url "titlu") u l-immaġini jsiru ![alt](src).
  • Il-listi jużaw il-marka magħżula (-, * jew +); il-listi ordnati jżommu n-numru start tagħhom, u l-listi nested jiġu indentati.
  • <pre><code> isir blokk tal-kodiċi, jew Bi fence (```) jew Indentati (4 spazji).
  • <blockquote>, <hr> u tmiem tal-linji jiġu kkonvertiti wkoll.
  • <script>, <style>, <iframe>, <noscript> u elementi simili jitneħħew mal-kontenut tagħhom.

Karattri li inkella jinqraw bħala sintassi Markdown, bħal * jew # fil-bidu ta’ linja, jgħaddu minn escape b’backslash biex it-test jibqa’ litterali.

GitHub Flavored Markdown

B’GitHub Flavored Markdown (tabelli, ~~strikethrough~~, listi ta’ kompiti) immarkat:

  • It-tabelli isiru tabelli bi pipes b’kolonni allinjati. L-intestatura tiġi minn ringiela <thead> jew ringiela magħmula biss minn ċelloli <th>; jekk ma jkunx hemm, tiżdied ringiela vojta tal-intestatura, għax il-GFM jeħtieġ waħda. L-allinjament tal-kolonni jinqara minn align="right" jew style="text-align: center". Pipes ġewwa ċelloli jgħaddu minn escape bħala \|, tmiem tal-linji jsir <br>, u colspan jimtela b’ċelloli vojta. <caption> jinkiteb bħala paragrafu fuq it-tabella.
  • <del>, <s> u <strike> isiru ~~strikethrough~~.
  • Il-checkboxes fil-bidu ta’ oġġetti tal-lista jsiru oġġetti ta’ lista ta’ kompiti: - [x] lest, - [ ] x’jonqos.

Il-Markdown m’għandux ekwivalenti għal tabelli nested, ringieli magħquda jew stil taċ-ċelloli. Tabella li fiha tabella oħra tinżamm bħala HTML mhux ipproċessat, li l-biċċa l-kbira tar-renderers tal-Markdown jaċċettaw. Mingħajr l-għażla GFM, kull tabella tinżamm bħala HTML.

Markdown → HTML

Fid-direzzjoni l-oħra, il-Markdown jitfassal b’parser konformi mas-CommonMark, bl-estensjonijiet GFM meta l-għażla tkun attiva. L-output huwa frammenti HTML, lesti biex jitwaħħlu f’CMS, template ta’ email jew paġna web. Meta Naddaf l-HTML (neħħi scripts u event handlers) tkun immarkata, l-HTML mhux ipproċessat inkorporat fil-Markdown jitnaddaf: tags <script>, attributi onclick u links javascript: jitneħħew. Neħħi l-marka biss għal Markdown li kteb int stess.

Mistoqsijiet frekwenti

L-HTML tiegħi jintbagħat lil server?

Le. Iż-żewġ konverżjonijiet jaħdmu kompletament fil-brawżer tiegħek, u l-paġna qatt ma ttella’ dak li twaħħal jew tiftaħ. Tista’ tikkonverti b’sigurtà dokumentazzjoni interna jew abbozzi.

Il-previżjoni hija sigura b’HTML mhux fdat?

Iva. Il-Previżjoni dejjem tgħaddi minn DOMPurify: scripts, formoli, frames u event handlers jitneħħew, il-links jinfetħu f’tab ġdid mingħajr aċċess għal din il-paġna, u immaġini mill-bogħod qatt ma jitgħabbew. Jintwerew biss immaġini inkorporati bħala data: URLs.

Għaliex xi partijiet tal-paġna tiegħi jisparixxu?

Il-Markdown jiddeskrivi biss l-istruttura tal-kontenut. Elementi tat-tfassil, klassijiet CSS, stili inline, formoli u widgets inkorporati m’għandhomx forma Markdown, għalhekk jinżamm biss it-test tagħhom. Scripts u stili jitneħħew għal kollox.

Nista’ nikkonverti paġna web sħiħa?

Iva. Waħħal is-sors sħiħ, inklużi <html> u <head>: jiġi kkonvertit biss il-kontenut ta’ <body>. Għal Markdown aktar nadif, waħħal biss il-parti tal-artiklu minflok in-navigazzjoni u l-footer.

Liema togħma ta’ Markdown juża l-output?

L-output isegwi s-CommonMark, l-istandard appoġġjat mill-GitHub, il-GitLab, l-Obsidian, il-biċċa l-kbira tal-ġeneraturi ta’ siti statiċi u ħafna editors tas-CMS. It-tabelli, l-strikethrough u l-listi ta’ kompiti jsegwu l-ispeċifikazzjoni GitHub Flavored Markdown.