uzcenojums

Ievads Markdown

Ievads Markdown

Ievads Markdown

Atlaide

Markdown ir teksts HTML pārveidošanas rīks. Mūsdienās tas ir kļuvis par vieglu iezīmēšanas aprakstu valodu klases faktisko sinonīmu. Tas izmanto vienkārša teksta formatēšanas sintaksi. Markdown ideja bija padarīt tīmekļa lapu un it īpaši emuāra ierakstu rakstīšanu tikpat vienkāršu kā e-pasta rakstīšana. 2017. gada novembra laikā mērķis ir sasniegts, un Markdown, kā arī tā atvasinājumi Asciidoc, Asciidoctor un Asciidoctor-pdf tiek plaši izmantoti.

Markdown koncentrējas tikai uz vienkāršu tekstu un atturas no visām citām sarežģītībām, kas atrodamas HTML. To ir viegli iemācīties, jo tas tiek turēts vienkārši, tāpēc arī ātrāk, jo tiek izmantotas minimālas rakstzīmes, kas galu galā arī samazina kļūdu iespējamību. Pamatdokumentu, kas parādīts Markdown redaktorā Stackedit, skatiet 1. attēlā. Kreisajā pusē redzat pirmkodu un labajā pusē atbilstošo HTML izvadi. Jūs, iespējams, pamanīsit, ka virsraksti ir vienkārši atzīmēti ar numuru # atbilstoši virsraksta hierarhijas līmenim.

Teksta pārveidošana

Vienkāršais teksts ir konvertējams uz XHTML (HTML) un daudziem citiem formātiem, izmantojot komandrindas rīkus, piemēram, Markdown vai Pandoc. Būtībā abi rīki izveido tikai HTML fragmentus un izraksta produkciju stdout. Pandoc piedāvā slēdzi “-o faila nosaukums”, lai HTML izvadi ierakstītu dotajā failā. Kā redzams zemāk, izvades fails tiek nosaukts par pamata.html un satur HTML fragmentu - divus virsrakstus un rindkopu.

$ pandoc -o pamata.HTML pamata.md $ cat basic.html 
Debian pakotņu izveides instrukcijas
 
Priekšvārds
 Atbildība par mašīnu nozīmē rūpēties par aparatūru, kā arī programmatūras komponentiem. Ikdienas dzīvē kā sistēmas administrators ir daudz labāk instalēt programmatūru kā programmatūras pakotni, nevis daudz avota failu. Tas samazina izmaksas, lai pareizi uzturētu sistēmu. $

Lai izveidotu atsevišķus HTML dokumentus ar pilnīgu HTML galveni, Pandoc slēdzi “-s” pieņem šādi:

$ pandoc -o pamata.html -s pamata.md $ cat basic.html        <style>   
Debian pakotņu izveides instrukcijas
 
Priekšvārds
 Atbildība par mašīnu nozīmē rūpēties par aparatūru, kā arī programmatūras komponentiem. Ikdienas dzīvē kā sistēmas administrators ir daudz labāk instalēt programmatūru kā programmatūras pakotni, nevis daudz avota failu. Tas samazina izmaksas, lai pareizi uzturētu sistēmu.

Priekšrocība, ka saturs tiek turēts atsevišķi no vizuālā displeja, ir tas, ka tas nesajauks jūsu vietnes izskatu. 1. versija.0.1, kuru izstrādāja Džons Grūbers un Ārons Svarts, tika izlaists 2004. gada decembrī un ir pieejams kā bezmaksas programmatūra (skat. Saites šī raksta beigās).

Teksta elementi

Virsraksti

Saskaņā ar atbilstošo HTML līmeni virsraksti tiek rakstīti ar numuru # šādi:

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

Attiecībā uz H1 un H2 tiek pieņemti divi alternatīvi rakstīšanas veidi:

H1 == H2 --

Lūdzu, ņemiet vērā, ka vienādības zīmju vai domuzīmju skaitam jāatbilst virsraksta rakstzīmju skaitam.

Uzsverot tekstu

Lai uzsvērtu tekstu, tiek atbalstīti šie elementi:

Saraksti

Markdown atbalsta nesakārtotus un sakārtotus sarakstus. Sakārtoti saraksti sākas ar zvaigznīti, plus vai mīnus zīmi. Kārtotie saraksti sākas tikai ar ciparu. Lai izveidotu apakškārtas, saraksta elementu atkāpt ar divām atstarpēm (Markdown, StackEdit) vai četrām atstarpēm (Pandoc), kā redzat zemāk:

1. augļi * ābols * banāns 2. dzērieni + ūdens + piens

Attēli

Vienkāršākais veids ir izmantot iekļauto stilu šādi:

![Debian logotips] (debian logotips.png “Debian logotips”)

Tiek parādīts atsauces attēls. Tiklīdz pārvietojat peles rādītāju virs attēla, redzat atbilstošo apraksta tekstu.

Kods un sintakses izcelšana

Ir divi varianti - iekšējais kods un kodu bloki. Iekšējais kods ir ierāmēts trīs aizmugurēs, piemēram, “” drukā (“Sveika, pasaule!!")" ". Kodu bloki sākas un beidzas ar trim taustiņiem, bet atsevišķās rindās šādi:

"print (" Sveika, pasaule!")"

Markdown neatbalsta sintakses izcelšanu, bet to dara dialekti, piemēram, Markdown Here.

Galdi

Markdown neatbalsta tabulas, bet gan paplašinājumus, piemēram, GFM un Markdown Here.

Blokzīmes

Bloķēti piedāvājumi sākas tikai ar zīmi “>”. Citēt tekstu kļūst diezgan ērti.

> "Ak! ir absurdi, ja ir stingrs un ātrs noteikums par to, ko vajadzētu> lasīt un ko nevajadzētu. Vairāk nekā puse mūsdienu kultūras ir atkarīga> no tā, ko nevajadzētu lasīt.">> Nopelnīšanas nozīme. (Oskars Vailds)

Saites

Saites attiecas uz citiem dokumentiem vai pašreizējā dokumenta sadaļām. Rakstīšanas stils ir līdzīgs attēliem, un to veido saites apraksts kvadrātiekavās un URL iekavās.

[Es esmu saites iekļauts saitē] (https: // linuxhint.com)

Turklāt jūs varat pievienot alternatīvu tekstu:

[Es esmu saites saite ar papildu tekstu] (https: // linuxhint.com “LinuxHint”)

Uz saitēm var atsaukties šādi:

[LinuxHint] [1] ... teksts ... [1]: https: // linuxhint.com

Tas ļauj dokumenta beigās viegli izveidot atsauču sarakstus, kā tas ir izplatīts zinātniskajos dokumentos.

Secinājums

Atzīmēšana ir diezgan vienkārša un obligāta ikvienam, kurš veic dokumentāciju un regulāri publicē saturu. Ir liels prieks to izmantot.

Atsauces

Spēles Tomb Raider for Linux apmācība
Tomb Raider for Linux apmācība
Tomb Raider ēna ir divpadsmitais papildinājums Tomb Raider sērijai - darbības piedzīvojumu spēļu franšīzei, kuru izveidoja Eidos Montreal. Spēli gan k...
Spēles Kā palielināt FPS Linux?
Kā palielināt FPS Linux?
FPS apzīmē Kadri sekundē. FPS uzdevums ir izmērīt kadru ātrumu video atskaņošanā vai spēļu izrādēs. Vienkāršos vārdos nepārtrauktu pilnekrāna attēlu s...
Spēles Populārākās Oculus App Lab spēles
Populārākās Oculus App Lab spēles
Ja esat Oculus austiņu īpašnieks, jums ir jāsazinās par sānu ielādi. Sānu ielāde ir process, kurā austiņās tiek instalēts saturs, kas nav veikals. Sid...