Phenquestions
Tuo pačiu metu antkainis yra labai lengvas ir lankstus. Populiariausias žymėjimo atvejis yra „License“ ir „README“ failai „GitHub“ saugykloje, tačiau jis taip pat yra integruojamas su vis daugiau TVS tinklaraščio įrašams tvarkyti ir netgi mokslinių straipsnių rašymui. Matematines lygtis galite pateikti naudodami „LaTeX“ įskiepius.
Vis dėlto jį dažniausiai naudoja kūrėjai. Tai labai naudinga kuriant pamokas ir dokumentus dėka sintaksės paryškinimo keliomis kalbomis ir palaikymo vaizdams bei net gifams.
Pradėkime nuo sąrankos, kuri leidžia mums peržiūrėti pateiktą dokumentą kartu su neapdorotu žymėjimo teksto failu.
„Atom“ teksto rengyklė ir žymėjimo peržiūra
Norėdami atsisiųsti, galite atsisiųsti ir įdiegti „Atom“ teksto rengyklę arba „Visual Studio“ kodą. Tiek „Atom“, tiek „VS Code“ turi iš anksto įdiegtus papildinius „Markdown Preview“. Čia bus naudojamas „Atom“, tačiau sintaksė liktų maždaug tokia pati, nesvarbu, kokį teksto redaktorių naudojate.
„Atom“ patikrinkite, ar įgalintas „Markdown Preview“ paketas (iš tikrųjų jis įjungtas pagal numatytuosius nustatymus). Sukurkite aplanką šiai žymėjimo pamokai ir ten atidarykite naują failą (CTRL + N) ir ten įveskite šį tekstą.
# Tai yra antraštė___
## Tai taip pat antraštė
Štai tekstas
Išsaugokite failą (CRTL + S) naudodami a .md pratęsimas. Pavyzdžiui, galite pavadinti failą kaip testą.md ir .md dalis pasakys „Atom“, kad tai yra žymėjimo failas ir plėtinys su juo veiks kaip numatyta. Peržiūrą galite sugeneruoti naudodami šį klavišų susiejimą (CTRL + SHIFT + M), kuris rodomas naujoje srityje šalia neapdoroto teksto failo.
Peržiūros sritį galite uždaryti naudodami tą patį klavišų susiejimą arba naudodami pačią GUI.
Viską sukūrę galime atidžiau pažvelgti į sintaksę ir pradėti kurti nuostabius dokumentus skriejant.
Pažymėjimo sintaksė
Kaip minėta anksčiau, pagrindinė „Markdown“ motyvacija yra skaitomumas. Tai reiškia, kad jokios neaiškios žymos ar įdėtos žymos ar kitos painiavos, sukeliančios eilutes. Vietoj to galime pradėti nuo simbolio „#“, nurodydami, kad ta konkreti eilutė yra antraštė.
# Ar antraštė.## Taip pat nurodo antraštę, bet su mažesniu šrifto dydžiu.
### Galite pereiti prie mažesnių dydžių
Linijos pertraukos
„Markdown“ ir toliau sutraukia visą tekstą į vieną milžinišką pastraipą, net kai neapdorotas tekstas yra suskaidytas į kelias skirtingas eilutes. Norėdami tai sušvelninti, galite naudoti du tarpus eilutės pabaigoje ir tada įdėti naujos eilutės simbolį (ty paspauskite
Sakinys „Štai kodėl ...“ prasidėjo nauja eilute, tačiau nėra atskirai nuo ankstesnės eilutės, o naudojant dvi naujas eilutes sukurtas platesnis atskyrimas.
Horizontali taisyklė
Horizontali taisyklė, kaip rodo pavadinimas, sukuria horizontalią liniją, kuri leidžia jums struktūrizuoti dokumentą ir jame logiškai atskirti. Yra du horizontaliosios taisyklės sukūrimo būdai. Pirmiausia reikia naudoti tris ar daugiau pabraukimų horizontaliai taisyklei sukurti.
# Antraštė 1___
Pastraipos ir antraštė atskiriamos horizontalia taisykle.
___
Kitas atskirtas skyrius
Kitas variantas (kurio nerekomenduosiu) yra naudoti tris ar daugiau brūkšnių „-“, bet jie taip pat naudojami nurodant, kad sakinys, esantis tiesiai virš jų, yra antraštė. Taigi, jei tarp sakinio ir horizontalios taisyklės po juo nėra naujos eilutės, tas sakinys bus antraštės formos.
Kursyvas, pusjuodis ir perbraukimas
Trijų iš jų sintaksė yra gana paprasta ir kalba pati už save.
** Tai paryškinta **__Tai taip pat paryškinta__
_ Tai kursyvas_
* Tai taip pat yra kursyvas *
~~ Tai perbraukta ~~
Pabėgimo personažas
Dabar gali paklausti, kaip jūs tiesiogine to žodžio prasme parašytumėte ** šiek tiek teksto ** į galutinį žymėjimo failą, jei jis kaskart jį pakeis paryškintu. Tai yra dalykas, su kuriuo susiduria ir dauguma programavimo kalbų, o sprendimas yra panašus į tuos - naudokite atgalinį brūkšnį. Tai tinka ir kitiems sintaksės elementams, ir nėra specialiai skirtas paryškintam stiliui.
\ ** Tai nebėra paryškinta \ **Jei norite parodyti patį atgalinio brūkšnio simbolį, naudokite du iš jų ir pan.
\\ Rodoma kaip vienas pasvirasis brūkšnys
Blokinės citatos ir kodų blokai
Blokinės citatos ir kodų blokai yra daug lengvesni. Blokuota citata gali būti naudojama norint pabrėžti svarbų dalyką, į kurį norite atkreipti skaitytojų dėmesį. Tai galima pasiekti naudojant kampinį laikiklį pradžioje, kaip parodyta.
# 1 antraštėLorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut
labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercise ullamco laboris
nisi ut aliquip ex ea commodo pasekmė. Duis aute irure dolor in reprehenderit per virpėjimą
velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non
protidentas, sunt in culpa qui officia deserunt mollit anim id est laborum.
> Tai yra tvarkinga jūsų dokumento poskyrio santrauka. A> pora eilučių, kurios stovi
iš viso turinio.
Turinys tęsiasi.
Štai kaip jis atrodo, kai jis pateikiamas.
Kodo blokams tiesiog įdėkite eilutes linijomis 4 ar daugiau tarpų. Tai yra tikrai
patogu kūrėjams ir operatoriams, norintiems dokumentuoti savo darbą. Vėliau pamatysime, kaip tai padaryti dar geriau.
„HyperLinks“ ir vaizdai
Hipersaitų sintaksė yra gana paprasta. Matomas tekstas rašomas laužtiniuose skliaustuose, o URL, į kurį jis nukreipia, rašomas apvaliuose skliaustuose šalia jo.
Vaizdų sintaksė yra panaši, išskyrus tai, kad ji prasideda šauktuku. Galite laisvai naudoti santykinį kelią savo projekto aplanke, kuris nurodo paveikslėlį, arba galite turėti viešą URL.
## „HyperLink“ ir „Image“ sintaksės iliustravimas___
Turėtumėte [apsilankyti pas mus] (https: // linuxhint.com) dažniau
Taip įterpiami vaizdai.
![SmugPug] (https: // įkelti.wikimedia.org / wikipedia / commons / d / d2 / Bonny_Bonita.JPG)
Lentelės
Kuriant lenteles žymėjime, tiesiogine prasme nupiešiamas stalo ascii (tiksliau „Unicode“) portretas.
## Lentelės| 1 stulpelis | 2 stulpelis | 3 stulpelis |
| --------- | --------- | --------- |
| Pirmoji eilutė | Pirmoji eilutė | Pirmoji eilutė |
| Antroji eilutė | Antroji eilutė | Antroji eilutė |
Sintaksė neturi būti tiksliai sulygiuota iš vienos eilutės į kitą, tačiau vamzdžio simbolis naudojamas perjungti į kitą stulpelį, o kita eilutė rodo, kad prasidėjo kita eilutė.
Išplėstinis žymėjimas
Tiems iš jūsų, kurie atėjote taip toli, čia yra tikrasis malonumas. Jei naudojate „Atom“, iš tikrųjų galite pakeisti „Markdown Preview Plus“ papildinį, skirtą „Markdown Preview Plus“. Kuris siūlo šias funkcijas.
1. Matematinės lygtys naudojant „LaTeX“:
Jūs iš tikrųjų galite įterpti „LaTeX“ scenarijus tarp dolerio ženklų ir jis bus pateiktas kaip „LaTeX“ scenarijus ir rodomas peržiūroje su klavišais CTRL + SHITFT + X. Jums net nereikia žinoti visų „LaTeX“, užtenka kelių fragmentų.
## „LaTex“ iliustravimas___
$$ | \ Psi \ rangle = \ alfa | 0 \ rangle + \ beta | \ rangle $$
2. Sintaksės paryškinimas
Užuot naudoję įtrauką kodo blokams nurodyti, iš tikrųjų galite naudoti užrašus, po kurių nurodomas kalbų, kuriomis tariamai parašytas jūsų scenarijus, pavadinimas. Kalbos, kurių sintaksė palaikoma, yra per daug, kad jas būtų galima išvardyti, bet čia yra „Python“ pavyzdys.
## Sintaksės paryškinimo iliustravimas___
"pitonas
importuok tai
def my_function ():
spausdinti ("Sveiki, pasauli!")
grąžinti 0
"
Yra daugybė skonių arba „Markdown“. „GitHub“ turi savo specialų alų ir sintaksė yra labai lanksti. Tai turėtų ne įbauginti vartotojus, o patenkinti įvairesnius jų vartotojus. Tai yra viena iš tų kalbų, kurią tiesiog supranti reikiamą pogrupį ir jis naudoja, užuot vargęs dėl techninių dalykų (nebent jus domina jo techniniai aspektai)!)
