Markdown tikriausiai yra geriausias būdas užsirašyti užrašus kompiuteryje. Mes paaiškiname, kaip jį naudoti

Norėdami užsirašyti užrašus kompiuteryje, daugelis iš mūsų žino tipišką: Word arba LibreOffice Writer. Tai yra geras pasirinkimas kai kuriems scenarijams, bet jei norime užsirašyti pastabas, padaryti tai greitai, turėti juos tam tikru formatu ir atidaryti su ne itin sunkia peržiūros programa, tikriausiai geriausia naudoti tai, kas žinoma kaip Akcijos kainos. Čia mes paaiškinsime, kas tai yra, kaip tekstas yra "pažymėtas" ir mes įvardinsime keletą redaktorių / žiūrovų, kurie yra verti Linux.

Markdown yra a šviesos žymėjimas, kurio tikslas yra maksimaliai padidinti įvesties ir išvesties skaitomumą ir publikavimo lengvumą. Kaip ir HTML, „Markdown“ rodo tekstą įvairiais būdais, atsižvelgiant į tai, kokį žymėjimą jame naudojame, pvz., pusjuodžiu ir kursyvu. Jį sukūrė Johnas Gruberis ir velionis Aaronas Swartzas, ir nesigilindami į jo istoriją paaiškinsime, kaip jį naudoti.

Kaip sukurti Markdown dokumentus

Markdown dokumento kūrimas yra kažkas tokio galime tai padaryti naudodami bet kurį paprasto teksto rengyklę. Tai tas pats HTML, bet Markdown rašyti lengviau. HTML naudoja įvesties ir išvesties žymas ir visais atvejais jose yra mažesni nei () simboliai, o tai nėra patogiausia spausdinti, bent jau ispaniška klaviatūra. Daugelis ženklų, kuriuos naudosime Markdown, taip pat turi būti dedami prieš ir po kiekvieno žodžio, tačiau dviejų žvaigždučių naudojimas nėra tas pats, kas simboliai, kuriuos naudoja HTML. Vienintelis dalykas, kurio jums reikia, be žymėjimų, yra išsaugoti failą su plėtiniu .md arba .markdown.

Akcijos kainos Jame nėra tiek daug parinkčių kaip HTML, bet jis to taip pat neketina. Internete galime rasti kai kurių, kurių dokumentų peržiūros programa, suderinama su Markdown, nepalaiko, tačiau dažniausiai naudojamos ir yra šios:

Erdvės Markdown

Nenorėčiau nei pradėti, nei baigti straipsnio be šios dalies. Ir kai kuriuose prekės ženkluose, pavyzdžiui, antraštėse ar sąrašuose, turite įdėti tarpas tarp simbolio ir teksto. Galime gauti laukiamą rezultatą be šių tarpų, tačiau tai pagerina skaitomumą ir yra laikoma gera praktika.

Antraštės Antraštės

HTML jie žinomi kaip 1-6 val. Semantiškai jie turi būti naudojami kaip indekso komponentai; Nereikia jų naudoti norėdami įdėti didesnį ar mažesnį tekstą. Teoriškai h1 turėtų būti tik puslapio antraštė, h2 yra h1 dalis, h3 yra h2 dalis ir pan. Pavyzdžiui, šio straipsnio „Kaip sukurti žymėjimo dokumentus“ yra h2, kuris yra bendrame straipsnyje su h1, ir „Antraštės antraštės“, o toliau bus h3, kurios yra jų kūrimo skyriaus dalis.

HTML žyma būtų TEXT, o Markdown – su dviem maišos ženklais priekyje:

## Tai būtų h2

Trinkelių skaičius nurodo antraštės numerį, didžiausias – 6.

Pusjuodis, kursyvas, perbrauktas ir paryškintas

Paryškinti tekstai (b o stiprus HTML) ir kursyvu (i o em HTML) atrodo labai panašiai, todėl gali suklaidinti. galima įdėti paryškintas tekstas aplink jį su dviem apatiniais brūkšniais, ir kursyvu su apatiniu brūkšniu kiekvienoje pusėje. Todėl tris pabraukimus tekstas būtų paryškintas ir kursyvus. Ir lygiai tas pats su žvaigždutėmis.

Kad būtų išvengta painiavos, kursyvui rekomenduočiau naudoti apatinį brūkšnį ir paryškintą dvi žvaigždutes:

**pajuodintas šriftas**
 _kursyvas_

Kai kurie žiūrintieji jo gali nepalaikyti, bet galite išbraukti tekstą du kartus uždėdami ūsus priekyje ir už jo (~~) ir paryškinkite jį kaip su žymekliu su dviem vienodais simboliais priekyje ir už jo (==) .

~~Išbraukta~~
==Paryškinta==

Nematau paryškinto VSCode ar kai kuriose „Linux“ peržiūros programose, bet matau „Vivaldi“ naršyklės pastabose.

Jei jums įdomu, kaip pabraukti, kaip keista, Markdown jo nėra. Jei reikia pabraukti tekstą, geriausia naudoti pabraukto teksto HTML žymą.

Galia ir indeksas

Jei norime įdėti a skaičius pakeltas į kitą, kuris yra laipsnis, galima padaryti įvedus pirmąjį skaičių, po to cirkumfleksą (^), o tada laipsnį: 2^4 parodytų 2⁴. Yra būdų, kaip skaičių įdėti į priešingą pusę (apatinis indeksas), tačiau kaip ir žymeklio tekstą, jį palaiko ne visi procesoriai. Tai pasiekiama naudojant ūsus Ñ kiekvienoje teksto arba skaičiaus pusėje: h~2~ arba atrodo h₂arba (jei nematote, įsivaizduokite, kad 2 yra mažesnis).

Pastraipos

Paprastai pastraipoms nereikia naudoti jokių žymėjimų, bet jūs turite žinoti keletą dalykų. Jie turi vadinamąjį sunkų pertrauką ir iš pradžių negalite įdėti tokio teksto, kuris būtų matomas eilėraštyje:

Viena sausio diena (kosmosas) (kosmosas)
Atrodo gera diena (kosmosas) (tarpas)
Didžiulė poezija (kosmosas)
Tinklaraštininkas parašė (tarpas) (tarpas)

Ankstesniame tekste Markdown viską deda iš eilės, bet gudrybė yra įdėti du tarpai kiekvienos eilutės pabaigoje. Tokiu būdu ji gerbia tai, ko mes ieškome. Arba galite pridėti pasvirąjį brūkšnį, o tai rekomenduojama, jei norite dėti to paties formato eilučių blokus (pusjuodžiu, kursyvu...) viso bloko pradžioje ir dviem simboliais.

Sąrašai

HTML yra mažiausiai trijų tipų sąrašai: sutvarkyti (su skaičiais priekyje), nerūšiuoti (taškais priekyje) ir apibrėžimai, ol, ul y dl atitinkamai HTML. „Markdown“ turime tą patį, ir jie būtų sukurti taip:

Netvarkomi sąrašai

Su brūkšneliu priekyje:

- Pirmas elementas
- Antrasis elementas
- Trečias elementas

ir taip pat su žvaigždute:

*Tai būtų pirma
*Ši antra
*Ir trečia

arba papildomi simboliai:

+ Pirmas taškas
+ Antras taškas
+ Trečias taškas

Jei norime sukurti posąrašį, vietoj vieno įdėsime du iš ankstesnių simbolių, posąrašiui – tris ir pan.

- Pirkite
-- Pienas
-- Slapukai

Tai taip pat galima padaryti su įtrauka (kelios tuščios vietos).

Sutvarkyti sąrašai

Sutvarkyti sąrašai sukuriami įrašant skaičių, po kurio seka tašką ir elementą:

1. Pirmas dalykas
2. Toliau seka
3. Ir tai vėliau

Arba taip pat su skliaustais vietoj taško:

1) 1 elementas
2) 2 elementas

Norėdami įtraukti posąraščius, turite pridėti įtrauką, atsižvelgiant į lygį, kurį norime pasiekti. Įprastas dalykas yra 4 tušti tarpai arba tai, ką duoda tabuliavimo klavišas (jei jį paspaudus, žymeklis perkeliamas į dešinę). Šiame pavyzdyje parengimas ir montavimas yra kairėje pusėje, o tarpiniai taškai yra keturi tarpai priešais:

1. Paruošimas:
    1. ISO atsisiunčiamas.
    2. Jis įrašytas į USB.
2. Montavimas:
    1. USB įdėtas į įrenginį.
    2. Tai...

Tai atrodytų taip:

1. Paruošimo būdas:
   1. ISO atsisiunčiamas.
   2. Jis įrašytas į USB.
2. Įrengimas:
   1. USB yra įdėtas į įrangą.
   2. JIS..

Turėkite omenyje, kad užsakyti sąrašai „Markdown“ visada seka eilės tvarka, o ne geriau. Jį galima sukurti naudojant 1., 1., 1. ir pamatysite 1., 2., 3.. Norėdami juos sulaužyti, turite pridėti tekstą tarp jų su dviguba eilučių pertrauka. Ir net jei tada įdėsite 2., tai bus tęsiama skaičiuojant.

Duomenų sąrašai

Duomenų sąrašai yra tie, kuriuose po termino pateikiamas apibrėžimas ir kuriuos galima sukurti taip (daugelis žiūrinčiųjų nepalaiko):

1 terminas
: 1 apibrėžimas

2 terminas
: 2a apibrėžimas
: 2b apibrėžimas

Užduočių sąrašas

Galite kurti užduočių sąrašus su nerūšiuotu sąrašo simboliu („-“, „*“ arba „+“), tarpu ir laužtiniais skliaustais. Jei jie yra su tuščia vieta, užduotį reikia atlikti; su "x" viduje, tai daroma:

- [ ] Sukurti straipsnį
- [x] Sveikiname su naujaisiais metais

Tai atrodytų taip:

• Sukurti straipsnį
• Sveikinu su naujais metais

Sąrašus galima derinti ir čia atsiliepia kiekvieno vaizduotė ir poreikiai.

Nuorodos į Markdown

Yra keletas būdų, kaip pridėti nuorodas į Markdown: greitas arba tiesioginis, įprastas ir nuoroda. Greitasis yra pridėkite nuorodą tokią, kokia yra, su pridedamu protokolu. Pavyzdžiui, https://linuxadictos.com daugumoje su Markdown suderinamų žiūrinčiųjų bus matoma kaip spustelėjama nuoroda. Tada turime šio tipo kalbos normalią ir pagal nuorodą.

Įprasta nuoroda dedama su tekstu laužtiniuose skliaustuose, o nuoroda ir jos pavadinimas o patarimas (jei yra, kabutėse) skliausteliuose:

[Geriausias Linux tinklaraštis](https://linuxadictos.com "Arba mes pabandome")

Nuorodos nuorodos yra šiek tiek sudėtingesnės, tačiau jos gali būti naudingos, nes jei mums reikia atlikti pakeitimus, modifikuojant nuorodą bus pakeistos visos ją naudojančios nuorodos. Sintaksė yra panaši, tačiau tekstas bus dedamas laužtiniuose skliaustuose, o po to – kituose laužtiniuose skliaustuose. Nuoroda nurodyta toliau. Geriau su pavyzdžiu nei su tūkstančiu žodžių:

[Geriausias Linux tinklaraštis][LXA] ... ... ... [LXA]: https://linuxadictos.com

Nuorodos paprastai pateikiamos dokumento pabaigoje.

Jei norime, kad nuoroda būtų rodoma be hipersaito, galime ją apjuosti atgaliniais arba atvirais diakritiniais ženklais (`), o tai yra pabėgimo būdas, apie kurį kalbėsime vėliau. Tai suteiks jai šiek tiek formatavimo, bet nesusies su niekuo.

Nuorodos į ID

Markdown taip pat leidžia kurti nuorodos į elementus su ID. Pirmasis būdas tai padaryti yra tai, kas dažniausiai bendrinama, bet man jis niekada nepasiteisino: {#el-id} turi būti pridėtas prie antraščių, už, o nuorodoje, o ne URL, turi būti ID. Pavyzdžiui, [to images](#images) nukreiptų į kitą tašką, jei jūsų žymėjimas būtų „## Images in Markdown {#images}“.

Yra du kiti būdai, kaip pridėti nuorodas į ID:

• Nuorodos į automatines antraštes: kai kurios teksto rengyklės ir kai kurios peržiūros programos ją palaiko, automatiškai prideda ID. Jei antraštė yra „A testas“, ID yra tas pats, tik mažosiomis raidėmis ir tarpai pakeičiami brūkšneliais. Sintaksė turėtų būti tokia:

[Tekstas, kurį norime rodyti](#a-test)

• Nuorodos su HTML ID: šis metodas prideda žymą (pvz., „a“, bet tai nėra privaloma) su norimu ID ir be jokio teksto tarp atidarymo ir uždarymo žymų, kad ji veiktų tik kaip nuoroda (). Nuoroda būtų lygiai tokia pati, kaip ir ankstesniame punkte.

Jei norime grįžti į dokumento viršų, užtenka tarp skliaustų įdėti maišos ženklą.

Estetinis triukas: jei kur nors kode pridėsime <style>* {scroll-behavior: smooth}</style>, matysime poslinkį; nešoks. Dėl šios problemos paaiškinsiu vėliau: kai kurios apimties gali rodyti tą eilutę tokią, kokia yra, užuot ją slėpusios.

Vaizdai Markdown

Jei supratote ankstesnį punktą, suprasite ir šį. Vaizdai pridedami beveik taip pat, kaip ir nuorodos, pagrindinis skirtumas yra tas, kad prieš jį yra šauktukas. Pavyzdžiui:

![Linux Mint Wallpapers](https://www.linuxadictos.com/wp-content/uploads/Fondos-de-screenla-de-Victoria.png „Pasiekiama sausio mėn.“)

Iš aukščiau pateiktų dalykų:

• ! rodo, kad tai vaizdas.
• [] Juose yra alternatyvus tekstas, HTML atributas „alt“.
• () Juose yra nuoroda į vaizdą, HTML atributas „src“.
• Informacinį tekstą, „pavadinimą“ HTML, galite įdėti tarp kabučių. Nereikia.

Jei norime, kad vaizdas nukreiptų į kitą puslapį, kuris yra paveikslėlis su nuoroda, tereikia pateikti aukščiau pateiktą tekstą laužtiniuose skliaustuose ir skliausteliuose pridėti nuorodą.

[![Linux Mint Wallpapers](https://www.linuxadictos.com/wp-content/uploads/Fundos-de-screenla-de-Victoria.png „Tai veda į DuckDuckGo“)](https://duckduckgo.com)

Kaip ir hipersaitų atveju, nuorodas galima pridėti pagal nuorodą, tačiau vaizdų nuorodose jos prasideda šauktuku.

Citatos

„Markdown“ citatos sukuriamos pastraipą pradedant simboliu didesnis nei, pavyzdžiui, „Pablinux“ sakė:

> Galvoju, tada... Kada valgai?

Tai parodytų:

Galvoju, tada... Kada valgai?

Jei reikėtų įdėti kabutes, būtų naudojama daugiau simbolių.

> Originali citata
>
>> Kas buvo paminėta citatoje

Tai atrodytų taip:

Originali citata

Kas buvo paminėta citatoje

Ir jei norime, kad citatoje būtų tuščios eilutės, kiekvienoje iš jų turi būti simbolis prieš jas, įskaitant tas, kurios yra tuščios:

> Pirma šmaikšti frazė
>
> Susitikimo pabaiga

parodytų:

Pirma šmaikšti frazė

Citatos pabaiga.

Kodas

Kodas pridedamas su skirtukais arba keturiais tuščiais tarpais prieš jį:

(tab)sudo pacman -Syu

Jei įdėsite tris kapo kirčius ir po jų pavadinimą, kai kurie žiūrovai kodą rodys specialiomis spalvomis, o kai kuriems žiūrovams bus rodomas net kalbos pavadinimas.

``` python
def testas ():
    Sveiki
```

Tai parodytų maždaug taip:

Horizontalios linijos

Horizontalias eilutes Markdown galima sukurti paliekant tik 3 ar daugiau žvaigždučių (***), brūkšnelių (-) arba apatinių brūkšnių (___). Rezultatas yra toks:

atkreipti

„Markdown“ lentelės iš esmės sukuriamos piešiant jas:

|Pirma|Antra|Trečia|
|:------|:------:|------:|
|Pirmas laukas|Antras laukas|Trečiasis laukas|
|Kažkas|Kažkas 2|Kažkas 3|

Bus rodoma (bet kitu formatu):

Nesvarbu, kokio dydžio paliksime ląstelėse.; kalba juos suformuos. Antroje, bene svarbiausioje, eilutėje galime nurodyti, kad tekstas lygiuojamas į kairę, į centrą arba į dešinę. Dvitaškis (:) nurodo, kur tekstas eina, priešingai, kai norime jį centruoti, dvitaškį turime dėti prieš ir už eilučių.

Matematinės formulės

Markdown taip pat leidžia pridėti matematines formules. Pavyzdžiui, galite įtraukti internetinę lygtį su dolerio ženklu priekyje ir už jo: $x2+y2=z^2$. Taip pat blokai su dviem doleriais:

$$\sum_{i=0}^ni^2 = \frac{(n^2+n)(2n+1)}{6}$$

Aukščiau pateiktų dalykų rezultatas atrodo taip VSCode (su skliausteliu prieš antrąjį n, kurį praleidau):

Pabėgimas nuo simbolių Markdown

Kartais gali tekti „pabėgti“ nuo kai kurių veikėjų. Pavyzdžiui, jei eilutės pradžioje įdėsime #, o tada tarpą, bus sukurtas h1. Galime to išvengti, prieš tai padarydami pasvirąjį brūkšnį, pavyzdžiui:

\# Antraštė

Taigi jis išeitų toks, koks yra, be formatavimo ir be pabėgimo simbolio. Yra dar keletas būdų, tačiau tai yra dažniausiai naudojama ir yra tokia pati kaip ir kitos kalbos.

Pažymėjimas naudojant HTML

Akcijos kainos iš dalies palaiko HTML žymas ir CSS taisykles, bet aš dėl to nestačiau. Ne visi žiūrovai viską rodo vienodai, todėl svarbu tai nepamiršti. Pavyzdžiui, jei naudojame „GitHub Markdown“ ir norime sulygiuoti vaizdą, naudodami <img align="left"> Gausime jį „plaukioti“ – plūduriavimas reiškia, kad tai, kas yra žemiau, pakyla ir dedama šalia – į kairę. Jį galima įdėti į priešingą pusę naudojant right, tačiau centrinė parinktis neveikia, nebent ji įvyniota į bloko žymą, pvz., arba .

Bet tai gali būti pasirinkimas. Jei norime, kad tekstas būtų raudonas, galime ištraukti HTML ir CSS, apsupti jį span tipo konteineriu ir į eilutę (žymoje) pridėti CSS taisykles atribute "style". Tai gali būti naudinga, pavyzdžiui, jei norime valdyti vaizdo dydį, bet, kaip sakiau, tai ne visada veikia.

Kada NEGALIMA naudoti Markdown

„Markdown“ yra tai, kas yra, ir ji buvo sukurta siekiant greitai ir konkrečiam naudojimui sukurti turinį. Jis gali būti naudojamas asmeniniams užrašams arba kaip HTML išankstinis apdorojimas, bet Jūs neturėtumėte jo naudoti, jei turite dirbti grupėje, kuri jo nenaudoja. Labiausiai paplitęs yra naudoti tekstų rengyklės, tiksliau Word ir jo .docx, todėl nenaudočiau Markdown, jei planuoju dalytis savo darbais. Jie tikriausiai net nežino, kaip juos peržiūrėti, nebent mes jiems duosime nuorodą į tokį straipsnį ;)

Markdown redaktoriai, skirti Linux

Šis straipsnis buvo ilgesnis nei tikėtasi, ir galbūt verta jį palikti kitam įrašui. Galbūt būtų pravartu užsiminti kai kuriuos, pvz Joplin, Apaštrofė arba Visual Studio Code tiems, kurie nori viską turėti vienoje vietoje. Kaip ir peržiūros priemonės, kai kurios numatytosios dokumentų peržiūros priemonės gali rodyti savo turinį.

Kad ir ką pasirinktumėte, verta naudoti Markdown asmeniniams užrašams. Pabandyk ir tu man pasakysi.

Santraukos lentelė