Įvadas į „Markdown“

Užsirašyk

Markdown yra teksto į HTML konversijos įrankis. Šiandien tai tapo lengvųjų žymėjimo aprašymo kalbų de facto sinonimu. Ji naudoja paprasto teksto formatavimo sintaksę. „Markdown“ idėja buvo padaryti internetinius puslapius ir ypač tinklaraščio įrašus taip pat lengva, kaip rašyti el. Laišką. 2017 m. Lapkričio mėn. Tikslas pasiektas, o „Markdown“ ir jo dariniai „Asciidoc“, „Asciidoctor“ ir „Asciidoctor-pdf“ yra plačiai naudojami.

„Markdown“ orientuojasi tik į paprastą tekstą ir susilaiko nuo visų kitų HTML sudėtinių dalių. Tai lengva išmokti, nes jis yra paprastas, todėl ir greitesnis, nes naudojami minimalūs simboliai, todėl galiausiai taip pat sumažėja klaidos tikimybė. Pagrindiniame dokumente, parodytame „Markdown“ redaktoriuje „Stackedit“, žr. 1 paveikslą. Kairėje pusėje matote šaltinio kodą, o dešinėje - atitinkamą HTML išvestį. Galite pastebėti, kad antraštės yra tiesiog pažymėtos skaičiumi #, atsižvelgiant į antraštės hierarchijos lygį.

Teksto konvertavimas

Paprastas tekstas konvertuojamas į XHTML (HTML) ir daugelį kitų formatų naudojant komandų eilutės įrankius, tokius kaip „Markdown“ ar „Pandoc“. Iš esmės abu įrankiai sukuria tik HTML fragmentus ir įrašo išvestį į stdout. „Pandoc“ siūlo jungiklį „-o filename“, kad HTML išvestis būtų įrašyta į nurodytą failą. Kaip matyti žemiau, išvesties failas pavadintas pagrindiniu.HTML ir jame yra HTML fragmentas - dvi antraštės ir pastraipa.

$ pandoc -o basic.HTML pagrindinis.md $ cat basic.HTML 
„Debian“ paketo kūrimo instrukcijos
 
Įvadas
 Būti atsakingu už mašiną reiškia rūpintis aparatine įranga ir programinės įrangos komponentais. Kasdieniniame gyvenime, kaip sistemos administratoriuje, daug geriau įdiegti programinę įrangą kaip programinės įrangos paketą, o ne daugybę šaltinio failų. Tai sumažina tinkamos sistemos priežiūros išlaidas. $ 

Norėdami sukurti atskirus HTML dokumentus su visa HTML antrašte, „Pandoc“ priima jungiklį „-s“ taip:

$ pandoc -o basic.HTML -s pagrindinis.md $ cat basic.HTML           
„Debian“ paketo kūrimo instrukcijos
 
Įvadas
 Būti atsakingu už mašiną reiškia rūpintis aparatine įranga ir programinės įrangos komponentais. Kasdieniniame gyvenime, kaip sistemos administratoriuje, daug geriau įdiegti programinę įrangą kaip programinės įrangos paketą, o ne daugybę šaltinio failų. Tai sumažina tinkamos sistemos priežiūros išlaidas.   

Turinio atskyrimo nuo vaizdinio ekrano privalumas yra tas, kad jis nesugadins jūsų svetainės išvaizdos. 1 versija.0.1, kurį sukūrė John Gruber ir Aaron Swartz, buvo išleistas 2004 m. Gruodžio mėn. Ir yra prieinamas kaip nemokama programinė įranga (žr. Nuorodas šio straipsnio pabaigoje).

Teksto elementai

Antraštės

Pagal atitinkamą HTML lygį antraštės rašomos su skaičiumi # taip:

# H1 ## H2 ### H3 #### H4 ##### H5 ###### H6 

H1 ir H2 yra du alternatyvūs rašymo būdai:

H1 == H2 -- 

Atkreipkite dėmesį, kad lygybės ženklų arba brūkšnių skaičius turi atitikti antraštės simbolių skaičių.

Teksto pabrėžimas

Norint pabrėžti tekstą, palaikomi šie elementai:

• kursyvas: pavienės žvaigždutės arba pavieniai pabraukimai
  --
  * svarbu * ir _taip pat svarbu_
  --
• paryškintas tekstas: dvigubos žvaigždutės arba dvigubi pabraukimai
  --
  ** svarbu ** ir __taip pat svarbu__
  --
• perbrauktas tekstas: dvigubos tildės
  --
  ~~ tekstas ~~
  --

Sąrašai

„Markdown“ palaiko nesutvarkytus ir užsakytus sąrašus. Užsakyti sąrašai prasideda žvaigždute, pliuso arba minuso ženklu. Užsakyti sąrašai tiesiog pradedami skaičiumi. Norėdami sukurti sublistus, įtraukite sąrašo elementą dviem tarpais („Markdown“, „StackEdit“) arba keturiais tarpais („Pandoc“), kaip matote toliau:

1. vaisiai * obuolys * bananas 2. gėrimai + vanduo + pienas 

Vaizdai

Paprasčiausias būdas yra naudoti įterptinį stilių taip:

![Debian logotipas] (debian logotipas.png „Debian logotipas“) 

Rodomas nurodytas vaizdas. Kai tik perkelsite pelės žymeklį virš vaizdo, pamatysite atitinkamą aprašo tekstą.

Kodo ir sintaksės paryškinimas

Yra du variantai - eilinis kodas ir kodų blokai. Įterptasis kodas yra sudarytas iš trijų užrašų, tokių kaip „“ spausdinimas („Sveikas, pasauli!")" ". Kodo blokai taip pat prasideda ir baigiasi trimis mygtukais, tačiau atskirose eilutėse taip:

"spausdinti (" Sveiki, pasauli!")"

Markdown nepalaiko sintaksės paryškinimo, bet dialektai, tokie kaip Markdown Here, daro.

Lentelės

Pažymėjimas nepalaiko lentelių, bet plėtiniai, pvz., GFM ir „Markdown Here“.

Blokinės citatos

Blokinės citatos tiesiog prasideda ženklu „>“. Cituoti tekstą tampa gana patogu.

> "Oi! absurdas yra griežta taisyklė, ką reikia> perskaityti ir ko ne. Daugiau nei pusė šiuolaikinės kultūros priklauso nuo to, ko nereikėtų skaityti.Uždirbimo svarba. (Oskaras Vaildas) 

Nuorodos

Nuorodos nurodo kitus dokumentus arba dabartinio skiltis. Rašymo stilius yra panašus į vaizdus ir susideda iš nuorodos aprašymo laužtiniuose skliaustuose ir URL įprastuose skliaustuose.

[Aš esu tiesioginio stiliaus nuoroda] (https: // linuxhint.com) 

Be to, galite pridėti alternatyvų tekstą:

[Esu tiesioginio ryšio nuoroda su papildomu tekstu] (https: // linuxhint.com „LinuxHint“) 

Nuorodos gali būti nurodomos taip:

[LinuxHint] [1] ... tekstas… [1]: https: // linuxhint.com 

Tai leidžia lengvai sudaryti nuorodų sąrašus dokumento gale, nes tai įprasta moksliniuose dokumentuose.

Išvada

Pažymėjimas yra gana paprastas ir būtinas visiems, kurie rengia dokumentus ir reguliariai skelbia turinį. Labai malonu ja naudotis.

Literatūra

• „StackEdit“, https: // stackedit.io / redaktorius
• Pandokas, http: // pandoc.org /
• Pažymėjimas, https: // drąsus ugnies kamuolys.grynasis / projektai / antkainis /
• „Markdown Cheatsheet“, https: // github.com / adam-p / markdown-here / wiki / Markdown-Cheatsheet