Kuinka työskennellä GitHub Flavored Markdownin kanssa Linuxissa
Markdown on muotoilukieli, joka on luotu verkkoa varten. Markdownin tarkoitus on tehdä elämästä helppoa, kun kirjoitamme Internetiin. Ajan mittaan on luotu monia makuelämyksiä. Mutta tässä artikkelissa keskitymme pääasiassa Github Flavored Markdowniin (GFM).
Github perustuu CommonMarkiin. GFM tukee monia lisäominaisuuksia, kuten taulukoita, koodien aitauksia jne. Hyppäämme sisään ja tutkimme GFM:n syntaksia ja sen käyttöä eri tapauksissa.
Käytän VScodea tämän osoittamiseen, mutta voit valita minkä tahansa sinulle sopivan Linux-editorin. Jotkin editorit, kuten Atom ja Vscode, sisältävät markdown-tuen, ja joillekin editoreille meidän on asennettava markdown-laajennus.
Jotta voit käyttää markdownia, tiedosto tulee tallentaa tunnisteella .md tai .markdown.
Otsikkeiden lisääminen Markdown-editoriin
Merkinnässä tuetaan 6 otsikkotasoa. Luo otsikko käyttämällä Hash (#) -symbolia, jota seuraa välilyönti ja otsikon nimi. Mitä suurempi hash-arvo, sitä pienempi otsikon koko.
HUOMAA: H1- ja H2-tyyli on oletuksena alleviivattu.
Heading1
## Heading2
### Heading3
#### Heading4
##### Heading5
###### Heading 6
Joskus saatat haluta kohdistaa otsikon kohti keskustaa. Mutta surullinen tarina on se, että kohdistusta ei tueta oletusarvoisesti markdownissa. Oletusarvoisesti otsikot hahmonnetaan vasemmalle tasattuina. Voit upottaa HTML/CSS-tunnisteita markdowniin tasauksen saavuttamiseksi.
<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>
Kuinka lisätä kommentteja Markdown Editoriin
Kommentit ovat tapa dokumentoida tiettyjä asioita koodin/asiakirjojen ymmärtämiseksi paremmin. Markdown-moottori ei renderöi tätä.
<!--
Comment block
-->
Tekstin renderöiminen yhdeksi riviksi
Normaalisti kun kirjoitat jotain eri riveille peräkkäin, merkintä tekee sen yhdeksi riviksi.
Voit luoda rivinvaihtoja kahdella tavalla.
- Pehmeä rivinvaihto
- Kovan linjan tauko
Pehmeät rivinvaihdot voidaan luoda lisäämällä rivin loppuun kaksi välilyöntiä. Tällä tavalla merkintä tekee jokaisesta rivistä erilliset rivit.
Kovan linjan vaihdot voidaan luoda lisäämällä tyhjä rivi jokaisen rivin väliin.
Kuinka lisätä vaakasuuntaisia viivoja
Vaakasuuntainen sääntö voidaan luoda lisäämällä kolme tai useampia tähtiä (*), yhdysmerkkejä (-) tai alaviivoja (_) yhdellä rivillä. Niiden väliin on myös hyvä lisätä tilaa.
* * *
---
___
Kuinka tehdä tekstistä lihavoitu
Jos haluat tehdä sanasta tai riveistä BOLD, ympäröi sana tai rivit kaksoistähtien (**) tai kaksoisalaviivan (__) välissä.
**Making this sentence bold using double asterisks.**
__Making this sentence bold using double underscore.__
Kuinka kursivoida tekstiä
Jos haluat tehdä sanoista tai riveistä KURSIVITEETTI, ympäröi sana tai rivit yksittäisten tähtien (*) tai yhden alaviivan (_) väliin.
*Making this line to be italicized using asterisks.*
_Making this line to be italicized using underscore._
Kuinka lisätä yliviivaus linjoihin
Jos haluat iskeä mihin tahansa, sinun on käytettävä kaksoistildettä. Ympäröi kaikki haluamasi kaksinkertaisten aaltojen (~~) välissä.
I am just striking the word ~~Howdy~~.
~~I am striking off the entire line.~~
Kuinka lisätä lohkolainaus
Käytä Suurempi kuin symboli (>) lainausmerkissä.
> Single line blockquote.
Katso, kuinka alla oleva lohkolainaus hahmonnetaan. Molemmat rivit renderöidään samalla rivillä.
> first line
> Second line
> Third line
> Fourth line
Voit käyttää rivinvaihtoa jättämällä kaksi välilyöntiä jokaisen rivin loppuun. Tällä tavalla jokaista riviä ei renderöidä yhdeksi riviksi.
Jätä vaihtoehtoiset rivit tyhjiksi etuliitteenä suurempi kuin -symboli. Näin voit luoda rivinvaihdon saman lohkon jokaisen rivin väliin.
> first line
>
> Second line
>
> Third line
>
> Fourth line
Voit myös luoda sisäkkäisiä lohkolainausmerkkejä lisäämällä kaksi suurempaa kuin symbolia (>>).
Luo sisäinen koodi
Käytä BACKTICK-toimintoa upotetun koodin luomiseen. Alla oleva esimerkki osoittaa, kuinka luodaan upotettu koodi. Katso sanan muistiinpanot ja readme, joka annettiin tekstin sisäisenä koodina.
Markdown is one of the best tools for taking `notes` and creating `readme` files.
Lisää koodilohkon syntaksin korostus
Lisää sarkain tai 4 välilyöntiä ja aseta koodisi, jotta se hahmonnetaan koodilohkona. Vaihtoehtoisesti voit sijoittaa koodisi kolmen backticksin väliin, jotta lohko hahmonnetaan koodilohkona. Tärkeä tässä huomioitava ominaisuus on syntaksin korostus. Normaalisti kun asetat koodin lohkoon, siihen ei sovelleta värimaailmaa.
```
echo "Hello world"
```
Katso nyt samaa esimerkkiä, värimaailma otetaan käyttöön automaattisesti. Tämä on mahdollista lisäämällä ohjelmointikielen nimi kolmen backticksin jälkeen, jotka soveltavat koodiin värimaailmaa.
```bash
echo "Hello world"
```
Esimerkki python-koodista.
```python
def fp():
print("Hello World!!!")
fp()
```
Esimerkki SQL-kyselystä.
```sql
SELECT MAX(SALARY_EMP) FROM EMPLOYEE_TABLE
WHERE SALARY_EMP<(SELECT MAX(SALARY_EMP) FROM EMPLOYEE_TABLE)
```
Luo järjestetyt ja järjestämättömät luettelot
Kohteet voidaan järjestää järjestetyiksi luetteloiksi ja järjestämättömiksi luetteloiksi markdownissa. Voit luoda järjestetyn luettelon lisäämällä numeroita ja pisteen. Mielenkiintoinen osa tässä on huomata, että numeron ei tarvitse olla peräkkäinen. Markdown-moottori on tarpeeksi älykäs ymmärtääkseen, että se on järjestetty luettelo, vaikka teemme ei-peräkkäisen tilauksen.
Alla olevassa esimerkissä voit nähdä, että loin järjestetyn luettelon ei-peräkkäisellä järjestyksellä (10, 15, 150), mutta merkintäkone hahmontaa sen oikeassa järjestyksessä. Voit myös luoda sisäkkäisen luettelon kuvan osoittamalla tavalla.
Järjestämättömän luettelon luomiseksi käytä plusmerkkiä (+) asteriskia (*) tai viivaa (-), jota seuraa välilyönti ja luettelon sisältö. Järjestetyn luettelon tapaan voit luoda sisäkkäisen luettelon myös tähän.
Luo tehtävälista
Tämä on GFM:n erikoisominaisuus. Voit luoda tehtäväluettelon alla olevan kuvan mukaisesti. Merkitse tehtävä suoritetuksi lisäämällä 'x' hakasulkeisiin kuvan osoittamalla tavalla.
Lisää linkkejä tekstiin
Lisää linkki noudattamalla alla olevaa syntaksia.
[Tecmint](https://linux-console.net "The best site for Linux")
Jaetaan syntaksi 3 osaan.
- Näytettävä teksti – Tämä on teksti, joka sijoitetaan hakasulkeisiin ([Tecmint]).
- Linkki – sijoitat varsinaisen linkin sulkeisiin.
- Otsikko – Kun viet hiiren osoittimen tekstin päälle, näkyviin tulee linkin työkaluvihje. Otsikko tulee sijoittaa lainausmerkkien sisään kuvan osoittamalla tavalla.
Alla olevasta kuvasta näet, että "Tecmint" on näyttötekstini, ja kun napsautan sitä, se ohjaa minut osoitteeseen linux-console.net.
Voit myös luoda linkkejä asettamalla ne kulmasulkeisiin < >.
Lisää linkkejä kuviin
Kuvan syntaksi näyttää samanlaiselta kuin linkkien lisääminen. Lisää kuva noudattamalla alla olevaa syntaksia.
Jaetaan syntaksi 3 osaan.
- Vaihtoehtoinen teksti – Vaihtoehtoinen teksti sijoitetaan hakasulkeisiin (![alt-text]). Jos kuva on rikki tai sitä ei voi ladata, tämä teksti näytetään yhdessä rikkinäisen symbolin kanssa.
- Linkki – sijoitat varsinaisen linkin kuvaan suluissa.
- Otsikko – Kun viet hiiren osoittimen kuvan päälle, näet kuvan nimen. Otsikko tulee sijoittaa lainausmerkkien sisään kuvan osoittamalla tavalla.
Voit myös luoda linkin kuvilla. Kun käyttäjä napsauttaa kuvaa, se ohjataan ulkoiseen linkkiin. Syntaksi pysyy samana pienin muutoksin. Ympäröi sama syntaksi, jota käytimme lisäämään kuvan hakasulkeisiin ja sen jälkeen linkin sulkeisiin.
[](https://en.wikipedia.org/wiki/Markdown)
Luo taulukko
Taulukoita ei tueta alkuperäisessä alennuksessa. Se on yksi GFM:n mukana tulevista erikoisominaisuuksista. Katsotaanpa, kuinka pöytä rakennetaan vaiheittain.
Ensimmäinen osa on luoda sarakkeiden nimet. Sarakkeiden nimet voidaan luoda erottamalla ne putkilla (|).
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID |
Käytä toisella rivillä viivoja (-) ja kaksoispistettä (:). Viivat kertovat merkintäkoneelle, että tämä on hahmonnettava taulukkona, ja kaksoispiste päättää, onko tekstimme tasattu keskelle, vasemmalle vai oikealle.
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID |
|:-------------:|:-------------|------------:|
:---: ⇒ Center alignment
:--- ⇒ Left alignment
---: ⇒ Right alignment
Kolmannelta riviltä voit aloittaa tietueiden luomisen. Tietueet tulee erottaa putkilla (|).
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID |
|:-------------:|:-------------|------------:|
| Ravi | 30 | 127 |
| karthick | 27 | 128 |
Yllä olevasta kuvasta näet, että taulukko on renderöity oikein. Sarake 1 on tasattu keskelle, sarakkeet 2 ja 3 on tasattu vasemmalle ja oikealle. Jos käytät Vscodea, voit muotoilla taulukon siististi käyttämällä Markdown Table Prettifier -toimintoa.
Luo emoji
GFM tukee laajaa valikoimaa hymiöitä. Katso emoji-huijauslehteä.
Siinä se tälle artikkelille. Jos sinulla on palautetta, lähetä se kommenttikenttään.