Kuidas töötada GitHubi maitsestatud Markdowniga Linuxis
Markdown on veebi jaoks loodud vormindamiskeel. Hinnahinna eesmärk on muuta elu lihtsaks, kui kirjutame Internetis. Aja jooksul on olemas Github Flavored Markdown (GFM).
Github põhineb CommonMarkil. GFM-is on palju täiendavaid funktsioone, nagu tabelid, koodiga tara jne. Hüppame ja uurime GFM-i süntaksit ja kuidas seda erinevatel juhtudel kasutada.
Ma kasutan Atomi ja Vscode'i, millel on märgistustugi, ja mõne redaktori jaoks peame installima märgistamise pistikprogrammi.
Märgistusega töötamiseks tuleks fail salvestada laiendina .md või .markdown .
Kuidas lisada pealkirju Markdown Editori
Märgistamisel on toetatud 6 pealkirja taset. Pealkirja loomiseks kasutage sümbolit Hash (#) , millele järgneb tühik ja pealkirja nimi. Suurema räsiväärtuse korral on pealkirja suurus väiksem.
MÄRKUS. H1 ja H2 on vaikimisi allajoonimise stiil.
# Heading1 ## Heading2 ### Heading3 #### Heading4 ##### Heading5 ###### Heading 6
Mõnikord võite soovida suunata suunda keskele. Kuid kurb lugu on joondamine, mida märgistamisel vaikimisi ei toetata. Vaikimisi renderdatakse päised vasakule joondusega. Joonduse saavutamiseks saate HTML/CSS-märgendeid kinnistada märgistusse.
<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>
Kuidas lisada kommentaare Markdown Editori
Kommentaarid on viis teatud dokumentide dokumenteerimiseks, et koodist/dokumentidest paremini aru saada. Märgistusmootor seda ei esita.
<!-- Comment block -->
Kuidas esitada teksti ühe reana
Tavaliselt renderdatakse markeering ühe reana, kui kirjutate midagi eraldi ridadesse üksteise järel.
Reavahetusi saate luua kahel viisil.
- Pehme joone katkestus
- Kõva joone katkestamine
Pehmete joonejoonte saab luua kahe tühiku lisamisega rea lõppu. Nii muudab märgistamine iga rea eraldi joonteks.
Kõva joone katkestusi saab luua, sisestades iga rea vahele tühja joone.
Kuidas lisada horisontaaljooni
Horisontaalse reegli saab luua, kui asetada ühele sirgele kolm või enam tärni (*), sidekriips (-) või alakriips (_). Samuti on ok nende vahele ruumi lisada.
* * * --- ___
Kuidas teha teksti paksuks
Sõna või ridade paksuks muutmiseks ümbritsege sõna või read topelttähtede (**) või topeltkriipsuga (__) .
**Making this sentence bold using double asterisks.** __Making this sentence bold using double underscore.__
Kuidas teha teksti kursiiv
Sõnade või ridade ITALICS tegemiseks ümbritsege sõna või read üksikute tärnide (*) või ühe alakriipsuga (_) .
*Making this line to be italicized using asterisks.* _Making this line to be italicized using underscore._
Kuidas lisada ridadele läbikriipsutus
Kõigi löömiseks peate kasutama topelttildet. Ümbritse kõik, mida vajate topelttildide (~~) vahel läbi löömiseks.
I am just striking the word ~~Howdy~~. ~~I am striking off the entire line.~~
Kuidas lisada plokkpakkumine
Blokeeringu pakkumiseks kasutage suuremat kui sümbolit (>) .
> Single line blockquote.
Vaadake, kuidas alltoodud plokktsitaati renderdatakse. Mõlemad read renderdatakse samal real.
> first line > Second line > Third line > Fourth line
Võite kasutada rea tagasitulekut, jättes iga rea lõppu kaks tühikut. Nii ei renderdata kõiki ridu ühes reas.
Jätke asendusliinid tühjaks, eesliitega suurem kui sümbol. Nii saate luua rea katkestuse sama ploki iga rea vahel.
> first line > > Second line > > Third line > > Fourth line
Samuti saate luua pesastatud plokk jutumärgid, lisades kaks sümbolist suuremat (>>) .
Loo sisemine kood
Sisemise koodi loomiseks kasutage nuppu BACKTICK. Allpool toodud näide näitab, kuidas luua sisekoodi. Vaadake sõna märkmeid ja readme, mis renderdati tekstisisese koodina.
Markdown is one of the best tools for taking `notes` and creating `readme` files.
Koodiploki süntaksi esiletõstmine
Lisage vahelehed või 4 tühikut ja asetage kood, et see koodiplokina renderdada. Teise võimalusena asetage kood kolme tagasilöögi vahele, et plokk renderdada koodplokina. Oluline funktsioon, mida siin tähele panna, on süntaksi esiletõstmine. Tavaliselt, kui panete koodi ploki sisse, ei rakendata sellele värvilahendust.
``` echo "Hello world" ```
Nüüd vaadake sama näidet, värviskeem rakendatakse automaatselt. See on võimalik, kui lisate programmeerimiskeele nime pärast kolme tagasilööki, mis rakendavad koodile värviskeemi.
```bash echo "Hello world" ```
Püütonikoodi näidis.
```python
def fp():
print("Hello World!!!")
fp()
```
SQL-päringu näidis.
```sql SELECT MAX(SALARY_EMP) FROM EMPLOYEE_TABLE WHERE SALARY_EMP<(SELECT MAX(SALARY_EMP) FROM EMPLOYEE_TABLE) ```
Loo tellitud ja tellimata loendid
Üksusi saab markdownis korraldada järjestatud loenditeks ja järjestamata loenditeks. Järjestatud loendi loomiseks lisage numbrid, millele järgneb punkt. Siinkohal tuleb märkida, et number ei pea olema järjestikune. Markdown mootor on piisavalt tark, et mõista, et see on järjestatud loend isegi siis, kui teeme järjestikku järjestamist.
Allpool toodud näites näete, et lõin järjestatud järjestusega järjestatud loendi (10, 15, 150), kuid märgistusmootor muudab selle õiges järjekorras. Samuti saate luua pesastatud loendi, nagu pildil näidatud.
Järjestamata loendi loomiseks kasutage plussmärki (+) tärnid (*) või kriips (-) , millele järgneb tühik ja loendi sisu. Sarnaselt tellitud loendiga saate ka siin luua pesastatud loendi.
Loo ülesandeloend
See on GFM-i eripära. Saate luua ülesannete loendi, nagu on näidatud alloleval pildil. Ülesande lõpetatuks märkimiseks peate ruudukujuliste sulgude vahele lisama pildil näidatud ‘x’ .
Lisage linke tekstile
Lingi lisamiseks järgige allolevat süntaksit.
[Tecmint](https://linux-console.net "The best site for Linux")
Jaotame süntaks kolmeks osaks.
- Kuvatav tekst - see tekst paigutatakse ruudukujuliste traksidega ([Tecmint]).
- Link - tegelik link asetatakse sulgudesse.
- Pealkiri - kui hõljutate kursorit teksti kohal, kuvatakse lingi tööriistavihje. Pealkiri tuleks panna jutumärkidesse, nagu pildil näidatud.
Allolevalt pildilt näete, et „Tecmint” on minu kuvatav tekst ja kui klõpsan, suunab see mind aadressile „linux-console.net”.
Samuti saate linke luua, asetades need nurksulgudesse <> .
Lisage linke piltidele
Pildi süntaks näeb välja sarnane linkide lisamisega. Pildi lisamiseks järgige allolevat süntaksit.
Jaotame süntaks kolmeks osaks.
- Alternatiivtekst - alternatiivtekst paigutatakse nurksulgude (! [alt-text]) vahele. Kui pilt on katki või seda ei saa laadida, kuvatakse see tekst koos katkise sümboliga.
- Link - sulgudes asetage tegelik link pildile.
- Pealkiri - kui hõljutate kursorit pildi kohal, kuvatakse pildi nimi. Pealkiri tuleks panna jutumärkidesse, nagu pildil näidatud.
Samuti saate luua lingi piltidega. Kui kasutaja klõpsab pilti, suunatakse see välisele lingile. Süntaks jääb väheste muudatuste korral samaks. Ümbritse sama süntaksit, mida kasutasime nurksulgudesse pildi lisamiseks, millele järgnes sulgudes olev link.
[](https://en.wikipedia.org/wiki/Markdown)
Looge tabel
Tabelid ei toeta märgistuse algset maitset. See on üks GFM-iga kaasnevatest eripäradest. Vaatame, kuidas järk-järgult tabelit koostada.
Esimene osa on veerunimede loomine. Veergude nimesid saab luua, eraldades need torudega (|) .
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID |
Teisel real kasutage sidekriipse (-) koos kooloniga (:) . Kriipsud ütlevad märgistusmootorile, et see renderdatakse tabelina ja koolon otsustab, kas meie tekst peaks olema keskel, vasakul või paremal joondatud.
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID | |:-------------:|:-------------|------------:| :---: ⇒ Center alignment :--- ⇒ Left alignment ---: ⇒ Right alignment
Kolmandast reast saate alustada kirjete loomist. Kirjed tuleks eraldada toruga (|) .
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID | |:-------------:|:-------------|------------:| | Ravi | 30 | 127 | | karthick | 27 | 128 |
Ülaltoodud pildilt näete, et tabel on korralikult renderdatud. Veerg 1 on joondatud keskel, veerud 2 ja 3 on vasakule ja paremale joondatud. Kui kasutate Vscode'i, saate tabeli kenaks vormindamiseks kasutada nuppu "Markdown Table Prettifier".
Looge emotikon
GFM toetab laia valikut emotikone. Heitke pilk emotikonide petulehele.
See on selle artikli jaoks. Kui teil on tagasisidet, postitage see kommentaaride jaotisesse.