Kako raditi s GitHub Flavored Markdown u Linuxu
Markdown je jezik za oblikovanje koji je stvoren za web. Svrha markdowna je olakšati život kada pišemo na internetu. S vremenom su se stvorile mnoge vrste umanjenja. Ali u ovom članku, naš fokus bit će uglavnom na Github Flavored Markdown (GFM).
Github temelji se na CommonMarku. Mnogo je dodatnih značajki podržanih u GFM-u kao što su tablice, ograđivanje koda, itd. Uskočimo i istražimo sintaksu za GFM i kako ga koristiti u različitim slučajevima.
Koristim VScode da to demonstriram, ali možete odabrati bilo koji Linux editor koji vam odgovara. Neki uređivači kao što su Atom i Vscode dolaze s podrškom za označavanje, a za neke uređivače moramo instalirati dodatak za označavanje.
Da biste radili s markdownom, datoteka bi trebala biti spremljena s .md
ili .markdown
kao ekstenzijom.
Kako dodati naslove u Markdown Editor
Postoji 6 razina naslova podržanih u označavanju. Za izradu naslova upotrijebite simbol Hash (#)
nakon kojeg slijedi razmak i naziv naslova. Što je veća hash vrijednost, manja je veličina naslova.
NAPOMENA: H1 i H2 će prema zadanim postavkama imati stil podcrtavanja.
Heading1
## Heading2
### Heading3
#### Heading4
##### Heading5
###### Heading 6
Ponekad ćete možda poželjeti poravnati smjer prema sredini. Ali tužna je priča što poravnanje nije podržano prema zadanim postavkama u označavanju. Prema zadanim postavkama, naslovi se prikazuju s lijevim poravnanjem. Možete ugraditi HTML/CSS oznake u markdown kako biste postigli poravnanje.
<h1 style="text-align:center">MARKDOWN</h1>
<h1 style="text-align:left">MARKDOWN</h1>
<h1 style="text-align:right">MARKDOWN</h1>
<h1 style="text-align:justify">MARKDOWN</h1>
Kako dodati komentare u Markdown Editor
Komentari su način dokumentiranja određenih stvari radi boljeg razumijevanja koda/dokumenata. Ovo neće biti prikazano pomoću mehanizma za označavanje.
<!--
Comment block
-->
Kako prikazati tekst kao jedan redak
Obično kada upisujete nešto u odvojene retke jedan za drugim, markdown će to prikazati kao jedan redak.
Prijelome retka možete izraditi na dva načina.
- Mekani prijelom retka
- Hardline break
Meki prijelomi retka mogu se stvoriti dodavanjem dva razmaka na kraju retka. Na ovaj način markdown će svaki redak prikazati kao zasebne retke.
Tvrdi prijelomi mogu se stvoriti umetanjem praznog retka između svakog retka.
Kako dodati vodoravne linije
Voravno pravilo može se stvoriti postavljanjem tri ili više zvjezdica (*), crtica (-) ili podvlaka (_) u jednom retku. Također je u redu dodati razmak između njih.
* * *
---
___
Kako podebljati tekst
Kako biste riječ ili retke učinili Podebljanim, okružite riječ ili retke dvostrukim zvjezdicama (**)
ili dvostrukom podvlakom (__)
.
**Making this sentence bold using double asterisks.**
__Making this sentence bold using double underscore.__
Kako napraviti tekst u kurzivu
Da biste riječi ili retke napravili KURIVOM, okružite riječ ili retke između jedne zvjezdice (*)
ili jedne podvlake (_)
.
*Making this line to be italicized using asterisks.*
_Making this line to be italicized using underscore._
Kako dodati precrtane linije
Da biste bilo što pogodili, morate koristiti dvostruku tildu. Okružite sve što trebate precrtati između dvostrukih tilda (~~)
.
I am just striking the word ~~Howdy~~.
~~I am striking off the entire line.~~
Kako dodati blok citat
Koristite veće od simbola (>)
za blockquote.
> Single line blockquote.
Pogledajte kako se prikazuje donji blok citat. Oba retka prikazana su u istom retku.
> first line
> Second line
> Third line
> Fourth line
Povratak retka možete koristiti tako da na kraju svakog retka ostavite dva razmaka. Na taj način svaki redak neće biti prikazan u jednom retku.
Ostavite alternativne retke prazne s prefiksom više od simbola. Na taj način možete stvoriti prijelom retka između svakog retka unutar istog bloka.
> first line
>
> Second line
>
> Third line
>
> Fourth line
Također možete stvoriti ugniježđene blok navodnike dodavanjem dva simbola veće od (>>)
.
Stvorite ugrađeni kod
Koristite BACKTICK za izradu ugrađenog koda. Primjer u nastavku pokazuje kako stvoriti ugrađeni kod. Pogledajte bilješke riječi i readme koji je prikazan kao ugrađeni kod.
Markdown is one of the best tools for taking `notes` and creating `readme` files.
Dodajte isticanje sintakse bloka koda
Dodajte tabulatore ili 4 razmaka i postavite svoj kod da biste ga prikazali kao blok koda. Alternativno, postavite svoj kod između tri kvačice kako bi se blok prikazao kao blok koda. Važna značajka koju ovdje treba napomenuti je isticanje sintakse. Obično kada postavite kod unutar bloka, na njega se ne primjenjuje shema boja.
```
echo "Hello world"
```
Sada pogledajte isti primjer, shema boja se primjenjuje automatski. To je moguće dodavanjem naziva programskog jezika nakon tri povratne kvačice koje će primijeniti shemu boja na kod.
```bash
echo "Hello world"
```
Primjer python koda.
```python
def fp():
print("Hello World!!!")
fp()
```
Primjer SQL upita.
```sql
SELECT MAX(SALARY_EMP) FROM EMPLOYEE_TABLE
WHERE SALARY_EMP<(SELECT MAX(SALARY_EMP) FROM EMPLOYEE_TABLE)
```
Napravite uređene i neuređene popise
Stavke se mogu organizirati u uređene popise i neuređene popise u markdownu. Za izradu uređenog popisa dodajte brojeve nakon kojih slijedi točka. Ovdje je zanimljivo napomenuti da broj ne mora biti uzastopan. Markdown motor je dovoljno pametan da shvati da je to uređeni popis čak i ako radimo nesekvencijalni poredak.
U donjem primjeru možete vidjeti da sam stvorio uređeni popis s nesekvencijalnim redoslijedom (10, 15, 150), ali ga motor za označavanje prikazuje u ispravnom redoslijedu. Također možete stvoriti ugniježđeni popis kao što je prikazano na slici.
Za izradu nesređenog popisa upotrijebite znak plus (+)
zvjezdice (*)
ili crticu (-)
nakon čega slijedi razmak i sadržaj popisa. Slično uređenom popisu, ovdje također možete stvoriti ugniježđeni popis.
Stvorite popis zadataka
Ovo je posebna značajka GFM-a. Možete izraditi popis zadataka kao što je prikazano na slici ispod. Da biste označili zadatak kao dovršen, morate dodati ‘x’
između uglatih zagrada kao što je prikazano na slici.
Dodajte veze tekstu
Da biste dodali vezu, slijedite donju sintaksu.
[Tecmint](https://linux-console.net "The best site for Linux")
Podijelimo sintaksu na 3 dijela.
- Tekst koji će se prikazati – Ovo je tekst koji će biti smješten unutar uglatih zagrada ([Tecmint]).
- Veza – stvarnu vezu ćete staviti unutar zagrade.
- Naslov – kada prijeđete mišem iznad teksta, prikazat će se opis za vezu. Naslov treba staviti unutar navodnika kao što je prikazano na slici.
Na donjoj slici možete vidjeti da je “Tecmint” moj tekst za prikaz i kada kliknem na njega, preusmjerit će me na “linux-console.net”.
Također možete stvoriti veze tako da ih postavite unutar uglastih zagrada < >
.
Dodajte veze na slike
Sintaksa za sliku izgleda slično dodavanju veza. Za dodavanje slike slijedite donju sintaksu.
![BrokenImage](https://www.bing.com/th?id=AMMS_ff6f3f7a38b554421b6e614be6e44912&w=110&h=110&c=7&rs=1&qlt=80&pcl=f9f9f9&cdv=1&dpr=1.25&pid=16.1 "Markdown logo")
Podijelimo sintaksu na 3 dijela.
- Zamjenski tekst – Zamjenski tekst bit će smješten između uglatih zagrada (![alt-text]). Ako je slika pokvarena ili se ne može učitati, ovaj tekst će biti prikazan zajedno sa pokvarenim simbolom.
- Veza – unutar zagrada smjestit ćete stvarnu poveznicu na sliku.
- Naslov – kada prijeđete mišem preko slike, prikazat će se naziv slike. Naslov treba staviti unutar navodnika kao što je prikazano na slici.
Također možete stvoriti vezu sa slikama. Kada korisnik klikne na sliku, ona će biti preusmjerena na vanjsku poveznicu. Sintaksa ostaje ista uz nekoliko izmjena. Okružite istu sintaksu koju smo koristili za umetanje slike unutar uglatih zagrada nakon čega slijedi poveznica unutar zagrade.
[![BrokenImage](https://www.bing.com/th?id=AMMS_ff6f3f7a38b554421b6e614be6e44912&w=110&h=110&c=7&rs=1&qlt=80&pcl=f9f9f9&cdv=1&dpr=1.25&pid=16.1 "Markdown logo")](https://en.wikipedia.org/wiki/Markdown)
Napravi tablicu
Tablice nisu podržane u izvornoj verziji markdowna. To je jedna od posebnih značajki koje dolaze s GFM-om. Pogledajmo kako napraviti stol korak po korak.
Prvi dio je stvaranje naziva stupaca. Nazivi stupaca mogu se stvoriti tako da se odvoje crtom (|)
.
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID |
U drugom retku upotrijebite crtice (-)
u kombinaciji s dvotočkom (:)
. Crtice govore stroju za označavanje da će ovo biti prikazano kao tablica, a dvotočka odlučuje hoće li naš tekst biti poravnat u sredini, lijevo ili desno.
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID |
|:-------------:|:-------------|------------:|
:---: ⇒ Center alignment
:--- ⇒ Left alignment
---: ⇒ Right alignment
Od trećeg retka možete početi stvarati zapise. Zapisi trebaju biti odvojeni crtom (|)
.
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID |
|:-------------:|:-------------|------------:|
| Ravi | 30 | 127 |
| karthick | 27 | 128 |
Na gornjoj slici možete vidjeti da je tablica ispravno prikazana. Stupac 1 je poravnat po sredini, stupci 2 i 3 su lijevo i desno. Ako koristite Vscode, možete koristiti “Markdown Table Prettifier” za uredno formatiranje tablice.
Stvorite emoji
GFM podržava širok raspon emojija. Pogledajte emotikone.
To je to za ovaj članak. Ako imate povratne informacije, objavite ih u odjeljku za komentare.