Hvernig á að vinna með GitHub bragðbætt Markdown í Linux


Markdown er sniðmál sem er búið til fyrir vefinn. Tilgangurinn með markdown er að gera lífið auðvelt þegar við erum að skrifa á netið. Með tímanum eru Github Flavored Markdown (GFM).

Github er byggt á CommonMark. Það eru fullt af viðbótareiginleikum studdir í GFM eins og töflum, kóðagirðingum osfrv. Við skulum hoppa inn og kanna setningafræðina fyrir GFM og hvernig á að nota það í mismunandi tilvikum.

Ég er að nota Atom og Vscode koma með markdown stuðningi og fyrir suma ritstjóra þurfum við að setja upp markdown viðbót.

Til að vinna með markdown ætti að vista skrána með .md eða .markdown sem viðbót.

Hvernig á að bæta fyrirsögnum við Markdown Editor

Það eru 6 stig fyrirsagnar studd í markdown. Til að búa til fyrirsögn skaltu nota Hash (#) táknið og síðan bil og heiti fyrirsagnarinnar. Hærra kjötkássagildið lækkar stærð fyrirsagnarinnar.

ATHUGIÐ: H1 og H2 verða sjálfgefið með undirstrikunarstíl.

# Heading1
## Heading2
### Heading3
#### Heading4
##### Heading5
###### Heading 6

Stundum gætirðu viljað stilla fyrirsögnina í átt að miðju. En sorglega sagan er að jöfnun er ekki studd sjálfgefið í markdown. Sjálfgefið er að fyrirsagnir eru sýndar með vinstri jöfnun. Þú getur fellt HTML/CSS merki inn í markdown til að ná jöfnun.

<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>

Hvernig á að bæta athugasemdum við Markdown Editor

Athugasemdir eru leið til að skrá ákveðna hluti fyrir betri skilning á kóða/skjölum. Þetta mun ekki birtast af markdown vélinni.

<!--
Comment block
-->

Hvernig á að gera texta sem eina línu

Venjulega þegar þú slærð eitthvað inn í aðskildar línur hverja á eftir annarri mun markdown gera það sem eina línu.

Hægt er að búa til línuskil á tvo vegu.

  • Mjúkt línuskil
  • Harðlínubrot

Hægt er að búa til mjúk línuskil með því að bæta við tveimur bilum í lok línunnar. Á þennan hátt mun markdown gera hverja línu að aðskildum línum.

Hægt er að búa til harðlínuskil með því að setja tóma línu á milli hverrar línu.

Hvernig á að bæta við láréttum línum

Hægt er að búa til láréttu regluna með því að setja þrjár eða fleiri stjörnur (*), bandstrik(-) eða undirstrik(_) á einni línu. Það er líka í lagi að bæta bili á milli þeirra.

* * *
---
___

Hvernig á að gera texta feitletraðan

Til að gera orð eða línur feitletrað skaltu umkringja orðið eða línurnar á milli tvöfaldra stjörnur (**) eða tvöfalda undirstrikunar (__).

**Making this sentence bold using double asterisks.**

__Making this sentence bold using double underscore.__

Hvernig á að gera texta skáletrað

Til að gera orð eða línur skáletraðar skaltu umkringja orðið eða línurnar á milli stakra stjörnur (*) eða stakrar undirstrikunar (_).

*Making this line to be italicized using asterisks.*

_Making this line to be italicized using underscore._

Hvernig á að bæta í gegnum strik í línur

Til að slá eitthvað þarftu að nota tvöfaldan tilde. Umkringdu allt sem þú þarft til að slá í gegn á milli tvöfaldra tilda (~~).

I am just striking the word ~~Howdy~~.

~~I am striking off the entire line.~~

Hvernig á að bæta við blokkatilvitnun

Notaðu Stærra en tákn (>) fyrir tilvitnun.

> Single line blockquote.

Sjáðu hvernig tilvitnunin hér að neðan er birt. Báðar línurnar eru sýndar í sömu línu.

> first line
> Second line
> Third line
> Fourth line

Þú getur notað línuskil með því að skilja eftir tvö bil í lok hverrar línu. Þannig verður hver lína ekki birt í einni línu.

Skildu varalínurnar eftir tómar ásamt stærra en tákni. Þannig er hægt að búa til línuskil á milli hverrar línu innan sama blokkar.

> first line
> 
> Second line
> 
> Third line
> 
> Fourth line 

Þú getur líka búið til hreiður gæsalappir með því að bæta við tveimur stærri en táknum (>>).

Búðu til innbyggðan kóða

Notaðu BACKTICK til að búa til innbyggðan kóða. Dæmið hér að neðan sýnir hvernig á að búa til innbyggðan kóða. Horfðu á orðskýringarnar og readme sem var gefið upp sem innbyggður kóða.

Markdown is one of the best tools for taking `notes` and creating `readme` files.

Bæta við merkingu á setningafræði kóðablokka

Bættu við flipa eða 4 bilum og settu kóðann þinn til að gera hann sem kóðablokk. Að öðrum kosti skaltu setja kóðann þinn á milli þriggja bakkafla til að gera blokkina sem kóðablokk. Mikilvægur eiginleiki sem þarf að taka fram hér er setningafræði auðkenning. Venjulega þegar þú setur kóðann innan blokkarinnar er ekkert litasamsetning notað á hann.

```
echo "Hello world"
```

Líttu nú á sama dæmi, litasamsetningin er beitt sjálfkrafa. Þetta er mögulegt með því að bæta nafni forritunarmálsins við á eftir þremur afturmerkjum sem munu nota litasamsetninguna á kóðann.

```bash
echo "Hello world"
```

Dæmi um python kóða.

```python
def fp():
  print("Hello World!!!")
fp()
```

Dæmi um SQL fyrirspurn.

```sql
SELECT MAX(SALARY_EMP) FROM EMPLOYEE_TABLE   
WHERE SALARY_EMP<(SELECT MAX(SALARY_EMP) FROM EMPLOYEE_TABLE)
```

Búðu til pantaða og óraðaða lista

Hægt er að raða hlutum í raða lista og óraðaða lista í markdown. Til að búa til raðaðan lista skaltu bæta við tölum og síðan punkti. Það sem er áhugavert að hafa í huga hér er fjöldi þarf ekki að vera í röð. Markdown vélin er nógu snjöll til að skilja að þetta er raðaður listi, jafnvel þótt við gerum raðpöntunina.

Í dæminu hér að neðan geturðu séð að ég bjó til pantaðan lista með óraðaða röðun (10, 15, 150) en niðurfærsluvélin gerir hann í réttri röð. Þú getur líka búið til hreiðraðan lista eins og sýnt er á myndinni.

Til að búa til óraðaðan lista skaltu nota plústákn (+) stjörnur (*) eða strik (-) á eftir með bili og innihaldi listans. Svipað og í röðuðum lista geturðu búið til hreiðraðan lista hér líka.

Búðu til verkefnalista

Þetta er sérstakur eiginleiki GFM. Þú getur búið til verkefnalista eins og sýnt er á myndinni hér að neðan. Til að merkja verkefnið sem lokið verður þú að bæta ‘x’ á milli ferhyrningslaga eins og sýnt er á myndinni.

Bættu tenglum við texta

Til að bæta við tengli skaltu fylgja setningafræðinni hér að neðan.

[Tecmint](https://linux-console.net "The best site for Linux")

Við skulum brjóta niður setningafræðina í 3 hluta.

  • Texti sem á að birta – Þetta er textinn sem verður settur innan ferningslaga ([Tecmint]).
  • Tengill – þú setur hlekkinn í svigann.
  • Titill – Þegar þú heldur músinni yfir textann mun hann sýna tól fyrir tengilinn. Titillinn ætti að vera innan gæsalappa eins og sýnt er á myndinni.

Á myndinni hér að neðan geturðu séð Tecmint er skjátextinn minn og þegar ég smelli á hann mun hann vísa mér á linux-console.net.

Þú getur líka búið til tengla með því að setja þá innan hornsviga < >.

Bættu tenglum við myndir

Setningafræði myndarinnar lítur út eins og að bæta við tenglum. Til að bæta við mynd skaltu fylgja setningafræðinni hér að neðan.

![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")

Við skulum brjóta niður setningafræðina í 3 hluta.

  • Varatexti – Varatexti verður settur á milli hornklofa (![alt-texti]). Ef mynd er biluð eða ekki hægt að hlaða þá birtist þessi texti ásamt brotnu tákni.
  • Tengill – Innan sviga muntu setja tengilinn á myndina.
  • Titill – Þegar þú heldur músinni yfir myndina mun hún sýna nafn myndarinnar. Titillinn ætti að vera innan gæsalappa eins og sýnt er á myndinni.

Þú getur líka búið til tengil með myndum. Þegar notandi smellir á myndina verður henni vísað á ytri hlekk. Setningafræðin er sú sama með fáum breytingum. Umkringdu sömu setningafræði og við notuðum til að setja inn mynd innan hornklofa og síðan tengill innan sviga.

[![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)

Búðu til töflu

Töflur eru ekki studdar í upprunalegu bragði markdown. Það er einn af sérkennum sem fylgja GFM. Við skulum sjá hvernig á að búa til borð skref fyrir skref.

Fyrsti hlutinn er að búa til dálkanöfn. Hægt er að búa til dálkanöfn með því að aðgreina þau með pípum (|).

| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID |

Í annarri línu, notaðu strik (-) ásamt tvípunkti (:). Strestrik segja markdown vélinni að þetta eigi að birtast sem töflu og tvípunkturinn ákveður hvort textinn okkar eigi að vera miðju-, vinstri- eða hægrijafnaður.

| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID |
|:-------------:|:-------------|------------:|

:---:  ⇒ Center alignment
:---   ⇒ Left alignment
---:   ⇒ Right alignment

Frá þriðju línu geturðu byrjað að búa til færslur. Færslur ættu að vera aðskildar með pípu (|).

| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID |
|:-------------:|:-------------|------------:|
|  Ravi         |   30         |  127        |
|  karthick     |   27         |  128        |

Af myndinni hér að ofan geturðu séð að taflan er rétt mynduð. Dálkur 1 er miðjujafnaður, dálkur 2 og 3 eru vinstri- og hægrijafnaðir. Ef þú ert að nota Vscode geturðu notað Markdown Table Prettifier til að forsníða töfluna snyrtilega.

Búðu til Emoji

GFM styður mikið úrval af emojis. Skoðaðu emoji-svindlblaðið.

Það er það fyrir þessa grein. Ef þú hefur einhverjar athugasemdir vinsamlegast sendu það í athugasemdareitinn.