Markdown vienkāršā sintakse padara to par lielisku HTML alternatīvu. Valoda vienmēr ir atbalstījusi HTML iegulšanu, taču tagad varat izvēlēties citu ceļu un iegult Markdown HTML.

Izmantojot vienkāršu bibliotēku, varat mitināt iegulto Markdown savās tīmekļa lapās un nekavējoties pārvērst to par pareizu HTML.

Ko dara md-block?

Jūsu pašreizējais process var ietvert Markdown failu izveidi ar roku un pēc tam to pārveidošanu HTML formātā. Šādi darbojas daudzas mūsdienu CMS lietojumprogrammas. Vai arī varat izmantot tādu sistēmu kā Leņķisks, lai atveidotu atzīmes lapās.

Md-block bibliotēka nav tikai alternatīva; tā vietā tas atbilst nedaudz citam lietošanas gadījumam. Tas pārvērš inline Markdown par līdzvērtīgu HTML. Varat iegult Markdown savos HTML failos un pēc pieprasījuma atveidot to klientam.

Lūk, kā tas varētu izskatīties:

<html>
<galvu>...</head>
<ķermeni>
<md bloks>
# Virsraksts
Dažas *iegultās* atzīmes, kuras "md-block" var pārvērst jūsu vietā!
</md-block>
</body>
</html>

Ieteicams iegulto Markdown kodu līdzināt pa kreisi bez ievilkumiem. Tas ir tāpēc, ka atšķirībā no HTML sākuma atstarpes var būt nozīmīgas Markdown.

Bibliotēka ievieš savu pielāgoto HTML elementu, md bloks. Lai gan šis elements nav daļa no HTML standarta, šī ir derīga tehnika. Web komponentu standarts (MDN) ietver API ar nosaukumu Custom Elements. Šī API atbalsta pielāgotu elementu dinamisku reģistrāciju, izmantojot JavaScript.

Pirms md-block bibliotēkas ielādes šī lapa tiks atveidota pazīstamā veidā:

Protams, jūs varat veidot md-block elementa stilu, lai tas izskatās vairāk kā teksta redaktorā. Izmantojot iepriekš formatētu atstarpi un monospace fontu, tas ir vismaz nedaudz vieglāk lasāms:

<stils>md-block { atstarpe: iepriekš; fontu saime: monospace; }</style>

Ja rakstāt pamācību par Markdown, jūs varētu vēlēties šādu rezultātu. Tas ļauj izskaidrot Markdown sintaksi, vienlaikus ļaujot viegli rediģēt Markdown paraugu:

Taču md-block ballīšu triks ir pārvērst šo Markdown galīgajā HTML.

Pat ar noklusējuma pārlūkprogrammas stiliem saturs tagad tiek rādīts tāpat kā jūsu parastais HTML, lai gan jūs to nosūtījāt pārlūkprogrammai kā Markdown:

Kā lietot md-block

Kad savai lapai esat pievienojis md-block bibliotēku, varat ierakstīt savu atzīmi md bloks elementi. Pēc tam bibliotēka automātiski formatēs jūsu Markdown, un jūs varat turpināt Markdown iegulšanu pēc vajadzības.

Tomēr šim procesam ir dažas variācijas.

Iegūstiet skriptu attālināti vai instalējiet to pats

Vienkāršākais veids, kā sākt, ir atsaukties uz bibliotēku oficiālajā md-block vietnē:

<skripta veids ="modulis" src="https://md-block.verou.me/md-block.js"></script>

Šī pieeja var nebūt visefektīvākā, taču tā noteikti ir ātrākā. Vienkārši pievienojiet šo kodu savam galvu un jūsu lapa automātiski atveidos visu md-block elementā HTML:

Protams, varat lejupielādēt šo JavaScript failu un mitināt to savā vietnē. Vai arī varat to instalēt, izmantojot npm:

npm uzstādīt md-bloķēt

Markdown Blocks vs. Inline Markdown

Noklusējuma elements, kas nosaukts pēc pašas bibliotēkas, ir md bloks. Bet jūs varat arī izmantot md-span elements iekļautajai atzīmei, piemēram, teksts teikuma vidū:

Iekļautās Markdown lietošanas gadījums, iespējams, ir retāk sastopams, taču jūs joprojām varat to izmantot:

<lpp>HTML rindkopa, kas satur <md-span>*slīps*</md-span> tekstu.</lpp>

Kā sintakse izcelt iezīmēšanas kodu blokus ar prizmu

Prizma ir sintakses marķieris, ko līdzradīja Lea Verou, md-block radītāja. Varat to izmantot, lai tīmekļa lapā izceltu iepriekš formatētus koda blokus, tostarp tos, ko ģenerē md-block.

Tātad, izmantojot šo HTML:

<html>
<ķermeni>
<md bloks>
```javascript
funkcijukvadrāts(numuru) {
atgriezties numurs * numurs;
}
```
</md-block>
<skripts src="prizma.js"></script>
</body>
</html>

Jūs redzēsit labi formatētu kodu ar sintaktisku izcelšanu:

Jūsu iespējas rakstīt tiešsaistē ir tikai palielinājušās

Tas, kā jūs izmantojat md-block, ir atkarīgs no jums, taču tā izmantošanai ir daudz izgudrojumu risinājumu. Varat to izmantot, lai palaistu ļoti vieglu CMS rakstniekiem, kuri ir pārliecināti, ka izmanto Markdown, bet ne HTML.

Markdown ir ideāla valoda plašai auditorijai. Tā pieņemšana ar tādiem rīkiem kā Slack, visticamāk, vēl vairāk palielinās lietojumu.