Teknobench

Tiontaire HTML go Markdown

Tiontaigh HTML go Markdown agus Markdown go HTML i do bhrabhsálaí, le táblaí GitHub, stríoc, liostaí tascanna agus réamhamharc sábháilte. Gan uaslódáil.

Tiontú

Réamhamharc

Tá an réamhamharc sláintithe: baintear scripteanna, foirmeacha agus láimhseálaithe teagmhas agus ní lódáiltear íomhánna cianda riamh.

Conas HTML a thiontú go Markdown

  1. Roghnaigh an treo: HTML → Markdown nó Markdown → HTML.
  2. Greamaigh do chód sa bhosca ionchuir, nó cliceáil Oscail comhad chun comhad .html, .htm, .md nó .txt a lódáil ó do ríomhaire (suas le 10 MB).
  3. Coigeartaigh na roghanna. Do HTML → Markdown is féidir leat stíl na Ceannteidil, an Marcóir liosta agus stíl na Bloic chóid a roghnú. Do Markdown → HTML, tá Sláintigh an HTML (bain scripteanna agus láimhseálaithe teagmhas) ar siúl de réir réamhshocraithe.
  4. Cliceáil Tiontaigh. Nuashonraítear an toradh agus tú ag clóscríobh freisin.
  5. Cóipeáil nó íoslódáil an toradh. Bogann Malartaigh an treo an toradh ar ais isteach san ionchur ionas gur féidir leat é a thiontú sa treo eile agus an babhta iomlán a sheiceáil.

Taispeánann an Réamhamharc faoin toradh conas a rindreáiltear an Markdown, ionas gur féidir leat an tiontú a sheiceáil ar an gcéad amharc.

An méid a dhéanann an tiontú HTML → Markdown

Léann an tiontaire do HTML le parsálaí an bhrabhsálaí féin, i ndoiciméad támh: ní rithtear scripteanna agus ní íoslódáiltear íomhánna. Ansin siúlann sé struchtúr an leathanaigh agus scríobhann sé coibhéis Markdown gach eiliminte:

  • éiríonn <h1> go <h6> ina gceannteidil. Scríobhann ATX (# Title) # go ######; cuireann Setext (le fo-líne) fo-líne === nó --- le ceannteidil leibhéal 1 agus 2 (úsáideann leibhéil 3 go 6 # i gcónaí).
  • éiríonn <strong> agus <b> **trom**, éiríonn <em> agus <i> _iodálach_, éiríonn <code> inlíne ina chúlchomharthaí.
  • éiríonn naisc [téacs](url "teideal") agus éiríonn íomhánna ![alt](src).
  • Úsáideann liostaí an marcóir roghnaithe (-, * nó +); coinníonn liostaí ordaithe a n-uimhir start, agus eangaítear liostaí neadaithe.
  • éiríonn <pre><code> ina bhloc cóid, Le fál (```) nó Eangaithe (4 spás).
  • Tiontaítear <blockquote>, <hr> agus bristeacha líne freisin.
  • Baintear <script>, <style>, <iframe>, <noscript> agus eilimintí cosúla lena n-ábhar.

Éalaítear carachtair a léifí mar chomhréir Markdown ar shlí eile, mar * nó # ag tús líne, le cúlslais ionas go bhfanann an téacs litriúil.

GitHub Flavored Markdown

Le GitHub Flavored Markdown (táblaí, ~~stríoc~~, liostaí tascanna) ticeáilte:

  • Éiríonn táblaí ina dtáblaí píopa le colúin ailínithe. Tagann an ceanntásc ó shraith <thead> nó ó shraith nach bhfuil inti ach cealla <th>; mura bhfuil ceann ann, cuirtear sraith cheanntásca fholamh leis, mar go bhfuil ceann de dhíth ar GFM. Léitear ailíniú colúin ó align="right" nó style="text-align: center". Éalaítear píopaí laistigh de chealla mar \|, éiríonn bristeacha líne <br>, agus líontar colspan le cealla folmha. Scríobhtar <caption> mar mhír os cionn an tábla.
  • Éiríonn <del>, <s> agus <strike> ~~stríoc~~.
  • Éiríonn ticbhoscaí ag tús míreanna liosta ina míreanna liosta tascanna: - [x] done, - [ ] to do.

Níl aon choibhéis ag Markdown do tháblaí neadaithe, sraitheanna cumaiscthe ná stíliú cille. Coinnítear tábla ina bhfuil tábla eile mar HTML amh, rud a nglacann formhór na rindreálaithe Markdown leis. Gan an rogha GFM, coinnítear gach tábla mar HTML.

Markdown → HTML

Sa treo eile, rindreáiltear an Markdown le parsálaí comhlíontach CommonMark, le síntí GFM nuair atá an rogha ar siúl. Is blúirí HTML an t-aschur, réidh le greamú i CMS, i dteimpléad ríomhphoist nó ar leathanach gréasáin. Nuair atá Sláintigh an HTML (bain scripteanna agus láimhseálaithe teagmhas) ticeáilte, glantar HTML amh atá leabaithe sa Markdown: baintear clibeanna <script>, tréithe onclick agus naisc javascript:. Díthiceáil é do Markdown a scríobh tú féin amháin.

Ceisteanna coitianta

An seoltar mo HTML chuig freastalaí?

Ní sheoltar. Ritheann an dá thiontú go hiomlán i do bhrabhsálaí, agus ní uaslódálann an leathanach an méid a ghreamaíonn nó a osclaíonn tú riamh. Is féidir leat doiciméadú inmheánach nó dréachtaí a thiontú go sábháilte.

An bhfuil an réamhamharc sábháilte le HTML neamhiontaofa?

Tá. Téann an Réamhamharc trí DOMPurify i gcónaí: baintear scripteanna, foirmeacha, frámaí agus láimhseálaithe teagmhas, osclaítear naisc i gcluaisín nua gan rochtain ar an leathanach seo, agus ní lódáiltear íomhánna cianda riamh. Ní thaispeántar ach íomhánna leabaithe mar URLanna data:.

Cén fáth a n-imíonn codanna de mo leathanach?

Ní chuireann Markdown síos ach ar struchtúr ábhair. Níl aon fhoirm Markdown ag eilimintí leagan amach, aicmí CSS, stíleanna inlíne, foirmeacha ná giuirléidí leabaithe, mar sin ní choinnítear ach a dtéacs. Baintear scripteanna agus stíleanna go hiomlán.

An féidir liom leathanach gréasáin iomlán a thiontú?

Is féidir. Greamaigh an fhoinse iomlán, <html> agus <head> san áireamh: ní thiontaítear ach ábhar <body>. Chun Markdown níos glaine a fháil, greamaigh an t-alt amháin seachas an nascleanúint agus an buntásc.

Cén bhlas Markdown a úsáideann an t-aschur?

Leanann an t-aschur CommonMark, an caighdeán a dtacaíonn GitHub, GitLab, Obsidian, formhór na ngineadóirí suíomh statach agus go leor eagarthóirí CMS leis. Leanann táblaí, stríoc agus liostaí tascanna sonraíocht GitHub Flavored Markdown.