Kigeuzi cha Bure

Weka alama kwenye Kigeuzi cha HTML

Badilisha maandishi ya Markdown kuwa msimbo wa HTML ulio tayari kwa uzalishaji na usaidizi wa onyesho la moja kwa moja.

Kuhusu zana hii

Markdown ni lugha nyepesi ya kubainisha iliyobuniwa na John Gruber mwaka wa 2004 ili kuwaruhusu waandishi watoe HTML iliyoundwa kwa kutumia kanuni za maandishi wazi: vibambo vya hashi vya vichwa, nyota za msisitizo, viambatisho vya orodha, vipashio vilivyowekwa ndani kwa msimbo. Umbizo limekuwa chaguomsingi la faili za README, uhifadhi wa nyaraka za kiufundi, rasimu za blogu, jenereta za tovuti tuli, na muktadha wowote ambapo uandishi unapaswa kusomeka kama maandishi wazi na kama matokeo yanayotolewa. Kubadilisha Alama hadi HTML ni hatua ya uwasilishaji ambayo inageuza chanzo kuwa ukurasa wa wavuti.

Kigeuzi hiki kinatumia maktaba iliyotiwa alama, kionyeshi cha Markdown kilichopitishwa zaidi katika JavaScript. Iliyotiwa alama inaauni CommonMark na GitHub Flavored Markdown (GFM), ambayo ina maana ya majedwali, vizuizi vya msimbo vilivyozungushiwa uzio, orodha za kazi, upigaji kura, na kuunganisha kazi zote kiotomatiki kwa usahihi pamoja na vipengele vya kawaida vya Markdown.

Pato ni HTML wazi - lebo za kisemantiki za vichwa, aya, orodha, viungo na picha, pamoja na ndoano za darasa za vizuizi vya msimbo ambapo zana za kuangazia sintaksia zinazitarajia. Bandika kwa njia safi kwenye CMS yoyote, hupachikwa katika jenereta za tovuti tuli, au hutumika kama .html ya pekee. Hakuna CSS au JavaScript imeongezwa; kupanga matokeo huachwa kwa muktadha wako wa chini wa mkondo.

Kwa nini Badilisha Alama kuwa HTML

Markdown ni muundo wa waandishi na watengenezaji wanapendelea; HTML ni umbizo la vivinjari vinavyotoa. Jenereta nyingi za tovuti tuli na majukwaa ya CMS hubadilisha Markdown hadi HTML nyuma ya pazia, lakini wakati mwingine unahitaji ubadilishaji kama hatua ya pekee - kubandika kwenye CMS ambayo haina usaidizi wa Markdown, kuzalisha HTML kwa barua pepe, kutoa onyesho la kukagua haraka, au kutoa matokeo yaliyotolewa kwa usindikaji zaidi.

HTML pia ni umbizo la kisheria la maudhui yoyote ambayo hatimaye yataonyeshwa kwenye kivinjari. Vijarida vya barua pepe vilivyoundwa kutoka kwa rasimu za Markdown, kurasa za hati zilizopachikwa katika programu kubwa za HTML, na machapisho ya blogu yaliyobandikwa kwenye wahariri ambao wanatarajia HTML zote kufaidika kutokana na ubadilishaji safi.

Jinsi ya kutumia

Bandika Markdown, pata HTML.

  1. Ongeza alama yako: Bandika maandishi ya Markdown kwenye eneo la ingizo au udondoshe faili ya .md. Kazi zote mbili za kawaida za Markdown na GitHub Flavored Markdown syntax.
  2. Geuza: Alama huchanganua Alama kuwa AST na kutoa HTML. Vipengele vya kawaida vya ndani (msisitizo, nguvu, viungo, msimbo, picha), vipengele vya kuzuia (vichwa, aya, orodha, nukuu za kuzuia), na viendelezi vya GFM (meza, msimbo wenye uzio, orodha za kazi, viungo otomatiki) vyote hutoa kwa usahihi.
  3. Hakiki: Kagua HTML iliyotolewa kwenye paneli ya onyesho la kukagua. Thibitisha vizuizi vya msimbo, majedwali, na vipengele vingine changamano vinaonekana kama inavyotarajiwa.
  4. Nakili au pakua: Nakili HTML kwenye ubao wa kunakili ili kubandikwa kwenye CMS, au hifadhi kama .html kwa matumizi ya pekee. Matokeo ni HTML5 ya kimantiki bila mitindo ya ndani.

Kesi za Matumizi ya Kawaida

Maelezo ya Kiufundi

Alama hutumia usanifu wa pasi mbili. Lexer huweka alama ya ingizo kuwa tokeni za kiwango cha kuzuia (vichwa, aya, orodha, vizuizi vya msimbo) na tokeni za ndani (msisitizo, viungo, picha). Kichanganuzi hutembeza mkondo wa ishara na kutoa HTML, kwa kutumia ndoano za kionyeshi kwa kila aina ya tokeni.

Viendelezi vya GitHub Flavored Markdown huwashwa kwa chaguo-msingi: majedwali (kwa kutumia sintaksia ya bomba), vizuizi vya msimbo vilivyo na uzio (vijiti vitatu vya nyuma vilivyo na vidokezo vya lugha), orodha za kazi (- [ ] na - [x]), upigaji kura (kwa kutumia miteremko miwili), na kuunganisha kiotomatiki kwa URL. Vizuizi vya msimbo hutoa msimbo uliofunikwa mapema na darasa la hiari la lugha kwa uangaziaji wa sintaksia ya chini.

Usafishaji wa pato huachwa kwa watumiaji wa mkondo wa chini. Alama hutoa chochote ingizo litazalisha, ikijumuisha HTML mbichi iliyopachikwa kwenye Markdown. Ukikubali ingizo lisiloaminika, endesha utoaji kupitia DOMpurify au kisafishaji taka cha HTML kabla ya kutoa kwenye kivinjari.

Mazoea Bora

Maswali yanayoulizwa mara kwa mara

Je, kubadilisha MARKDOWN hadi HTML kunabadilisha maudhui?
Maudhui yanahifadhiwa kwa usahihi iwezekanavyo. Hata hivyo, baadhi ya vipengele vya umbizo mahususi huenda visiwe na vilingana vya moja kwa moja, kwa hivyo tofauti ndogo za umbizo zinaweza kutokea.
Umbizo la HTML linatumika kwa nini?
HTML (Lugha ya Alama ya HyperText) hutumiwa kimsingi kwa kurasa za wavuti na yaliyomo kwenye wavuti.
Je, kuna mapungufu yoyote ya kufahamu?
Faili za hadi MB 50 zinaweza kutumika. Faili kubwa sana au changamano zinaweza kuchukua muda mrefu kuchakatwa. Ugeuzaji wote hufanyika kwenye kivinjari chako, kwa hivyo kasi ya kuchakata inategemea kifaa chako.
Je, ubadilishaji huu ni salama na wa faragha?
Ndiyo. Uchakataji wote hufanyika kwenye kivinjari chako. Data yako haiachi kamwe kwenye kifaa chako - hakuna upakiaji wa seva, hakuna usindikaji wa wingu, hakuna mkusanyiko wa data.
Je, emoji zinatumika?
Emoji za Unicode hupitia moja kwa moja (kuandika emoji ya moyo huonyesha moyo katika utoaji). Mtindo wa GitHub :emoji: shortcodes hazibadilishwi kwa chaguo-msingi; ongeza kiendelezi ikiwa unahitaji hiyo.
Je, Markdown yangu imepakiwa kwenye seva?
Hapana. Imetiwa alama inaendeshwa katika kivinjari chako; uongofu hutokea kabisa kwenye kifaa chako.
Je! ninaweza kuongeza mtindo maalum kwenye HTML?
Ndiyo, baada ya uongofu. Pato ni HTML wazi ya semantic; tumia CSS yako mwenyewe kwa vichwa vya mitindo, vizuizi vya msimbo, majedwali na vipengele vingine.
Je, inaauni maelezo ya chini?
Kawaida CommonMark haibainishi sintaksia ya tanbihi. Baadhi ya viendelezi vya Markdown vinaauni [^1] sintaksia ya tanbihi; kigeuzi hiki kinafuata GFM, ambayo haijumuishi maelezo ya chini.