smanjenje

Markdown Vodič - od postava do sintakse

Markdown Vodič - od postava do sintakse
Oznaka je jednostavan za čitanje i jednostavan za naučiti označni jezik. Za razliku od HTML-a, XML-a ili drugih označnih jezika, gdje suludi broj nejasnih oznaka izgleda nepristupačno, označavanje je vrlo čitljivo čak i kao sirova tekstualna datoteka.

U isto vrijeme, umanjenje je vrlo malo i fleksibilno. Najpopularniji slučaj upotrebe umanjenja je za datoteke Licence i README u GitHub spremištu, ali se također integrira sa sve više i više CMS-a za upravljanje postovima na blogu, pa čak i pisanje istraživačkih radova. Možete prikazati matematičke jednadžbe s dodacima za LaTeX.

Međutim, uglavnom ga koriste programeri. Doista je korisno u izradi vodiča i dokumentacije zahvaljujući isticanju sintakse za više jezika i podršci za slike, pa čak i GIF-ove.

Počnimo s postavkom koja nam omogućuje pregled prikazanog dokumenta uz sirovu tekstualnu datoteku oznake.

Atom Text Editor i Markdown Preview

Možete preuzeti i instalirati Atom Text Editor ili Visual Studio Code kako biste nastavili. Atom i VS Code imaju unaprijed instalirane dodatke za Markdown Preview. Ovdje će se koristiti Atom, ali sintaksa će ostati približno ista bez obzira na to koji uređivač teksta koristite.

Na Atomu provjerite je li omogućen paket Markdown Preview (zapravo je omogućen prema zadanim postavkama). Stvorite mapu za ovaj vodič za označavanje i tamo otvorite novu datoteku (CTRL + N) i tamo unesite sljedeći tekst.

# Ovo je naslov
___
## Ovo je također naslov
Evo malo teksta

Spremite datoteku (CRTL + S) pomoću .md produžetak. Na primjer, datoteku možete imenovati kao test.md i .md dio će reći Atomu da je ovo datoteka s oznakom i da će ekstenzija raditi s njom kako je predviđeno. Pregled možete generirati pomoću sljedećeg povezivanja tipki (CTRL + SHIFT + M) koje je prikazano u novom oknu pored datoteke sirovog teksta.

Okno za pregled možete zatvoriti pomoću istog vezivanja tipki ili pomoću samog GUI-ja.

Uz sve postavljeno, možemo detaljnije pogledati sintaksu i početi stvarati nevjerojatne dokumente u hodu.

Sintaksa umanjenja

Kao što je ranije spomenuto, glavna motivacija iza Markdowna je čitljivost. To znači da ne postoje nejasne oznake ili ugniježđene oznake ili bilo koja druga zbunjenost koja uzrokuje zabune. Umjesto toga, možemo započeti sa simbolom '#' da označimo da je taj redak naslov.

# Je li naslov.
## Također označava naslov, ali s manjom veličinom fonta.
### Možete ići na uzastopno manje veličine

Prekidi crte

Markdown nastavlja sakupljati sav tekst u jedan ogroman odlomak čak i kad je sirovi tekst razbijen u nekoliko različitih redaka. Da biste to ublažili, možete upotrijebiti dva razmaka na kraju retka, a zatim staviti znak novog retka (to jest, pogodak ) ili jednostavno upotrijebite dva znaka za novi redak za malo drugačiji efekt kao što je prikazano dolje.

Rečenica „Zbog čega ...“ započela je u novom retku, ali nije odvojena od prethodnog retka, dok je upotreba dva nova retka stvorila šire razdvajanje.

Vodoravno pravilo

Horizontalno pravilo, kao što i samo ime govori, stvara vodoravnu crtu koja vam omogućuje strukturiranje dokumenta i logičko razdvajanje u njemu. Postoje dvije metode za stvaranje vodoravnog pravila. Prvo je korištenje tri ili više donjih crta za stvaranje vodoravnog pravila.

# Poglavlje 1
___
Stavak i naslov odvojeni su vodoravnim pravilom.
___
Još jedan odvojeni odjeljak

Druga opcija (koju neću preporučiti) je korištenje tri ili više crtica '-', ali se također koriste da naznače da je rečenica neposredno iznad njih naslov. Dakle, ako nemate novog reda između rečenice i vodoravnog pravila ispod nje, ta će rečenica poprimiti oblik zaglavlja.

Kurziv, podebljano i precrtano

Sintaksa za njih troje prilično je jednostavna i govori sama za sebe.

** Ovo je podebljano **
__Ovo je i podebljano__
_Ovo je kurziv_
* Ovo je također kurziv *
~~ Ovo je precrtano ~~

Lik za bijeg

Sad bi se netko mogao zapitati, kako biste doslovno napisali ** Neki tekst ** u konačnu datoteku umanjenja ako to svaki put samo podeblja. To je nešto čime se bavi i većina programskih jezika, a rješenje je slično onima - upotrijebite znak s kosom crtom. To vrijedi i za ostale elemente sintakse, a nije posebno za podebljani stil.

\ ** Ovo više nije podebljano \ **
Ako želite prikazati sam znak povratne kose crte, upotrijebite dva od njih i tako dalje.
\\ Prikazuje se kao jedna kosa crta

Blok citati i blokovi koda

Blok citati i blokovi koda puno su jednostavniji. Blok citat može se upotrijebiti za isticanje važne točke na koju želite skrenuti pažnju čitatelja. To se može postići korištenjem desnog kutnog nosača na početku, kao što je prikazano.

# Naslov 1
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 naprezanje ullamco laboris
nisi ut aliquip ex ea commodosequat. Duis aute irure dolor in reprehenderit in voluptate
velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non
proident, sunt in culpa quifficia deserunt mollit anim id est laborum.
> Ovo je uredan sažetak pododjeljka vašeg dokumenta. A> nekoliko redaka koji stoje
izvan ostatka sadržaja.
Sadržaj se nastavlja.

Evo kako to izgleda kada se prikazuje.

Za blokove koda, crte redaka jednostavno uvucite za 4 razmaka ili više. Ovo je stvarno

zgodan za programere i operatore koji žele dokumentirati svoj rad. Kasnije ćemo vidjeti kako to učiniti još boljim.

Hiperveze i slike

Za hiperveze je sintaksa prilično jednostavna. Vidljivi tekst zapisan je u uglastim zagradama, a URL na koji upućuje ispisan je u okruglim zagradama odmah do njega.

Za slike je sintaksa slična, osim što započinje uskličnikom. Slobodno možete koristiti relativni put u mapi vašeg projekta koji upućuje na sliku ili možete imati javni URL.

## Ilustrira sintaksu HyperLink i Image
___
Trebali biste nas [posjetiti] (https: // linuxhint.com) češće
Tako se ugrađuju slike.
![SmugPug] (https: // upload.wikimedia.org / wikipedia / commons / d / d2 / Bonny_Bonita.JPG)

Stolovi

Stvaranje tablica u označavanju uključuje doslovno crtanje ascii (točnije Unicode) portreta tablice.

## Tablice
 
| Stupac 1 | Stupac 2 | Stupac 3 |
| --------- | --------- | --------- |
| Prvi red | Prvi red | Prvi red |
| Drugi red | Drugi red | Drugi red |

Sintaksa ne mora biti točno poravnana iz jednog retka u drugi, ali znak cjevovoda koristi se za prebacivanje na sljedeći stupac, a sljedeći redak označava da je sljedeći redak počeo, općenito.

Prošireni Markdown

Za vas koji ste dosad stigli, evo prave poslastice. Ako koristite Atom, zapravo možete zamijeniti dodatak za pregled Markdown za Markdown Preview Plus. Koji nudi sljedeće funkcionalnosti.

1.   Matematičke jednadžbe pomoću LaTeX-a:

Zapravo možete umetnuti LaTeX skripte između znakova dolara i one će biti prikazane kao LaTeX skripta i prikazane u pregledu s CTRL + SHITFT + X. Ne morate čak ni znati sve LaTeX-e, dovoljno je samo nekoliko isječaka.

## Ilustrira LaTex
___
$$ | \ Psi \ rangle = \ alpha | 0 \ rangle + \ beta | \ rangle $$

2. Isticanje sintakse

Umjesto da koristite uvlačenje za označavanje blokova koda, zapravo možete koristiti povratne znakove iza kojih slijedi naziv jezika na kojima je vaša skripta navodno napisana. Jezici čija je sintaksa podržana previše su da bi ih se ovdje moglo navesti, ali evo primjera u pythonu.

## Ilustriranje isticanja sintakse
___
"piton
uvezi ovo
def my_function ():
print ("Pozdrav, Svijet!")
povratak 0
"

Postoje mnogi okusi ili Markdown. GitHub ima svoje posebno pivo i sintaksa je vrlo fleksibilna. To ne bi trebalo zastrašiti korisnike, već da bi ih udovoljilo većoj raznolikosti. Jedan je od onih jezika koji samo razumije podskup koji mu treba i koristi ga, umjesto da vas smetaju tehničke osobine (osim ako vas ne zanimaju njegove tehničke osobine!)

Vodič za OpenTTD
OpenTTD je jedna od najpopularnijih igara za poslovnu simulaciju. U ovoj igri morate stvoriti prekrasan prijevoznički posao. Međutim, počet ćete u poč...
SuperTuxKart za Linux
SuperTuxKart sjajan je naslov osmišljen kako bi vam besplatno pružio iskustvo Mario Kart na vašem Linux sustavu. Prilično je izazovno i zabavno igrati...
Vodič za bitku za Wesnoth
Bitka za Wesnoth jedna je od najpopularnijih strateških igara otvorenog koda koje trenutno možete igrati. Ne samo da se ova igra razvija već jako dugo...