Kako delati z oznako z okusom GitHub v Linuxu
Markdown je jezik za oblikovanje, ki je ustvarjen za splet. Namen pribitka je olajšati življenje, ko pišemo po internetu. Sčasoma obstajajo Github Flavored Markdown (GFM).
Github temelji na CommonMark. V GFM je na voljo veliko dodatnih funkcij, kot so tabele, ograjevanje kod itd. Skočimo in raziščimo sintakso GFM in kako jo uporabiti v različnih primerih.
Uporabljam Atom in Vscode s podporo za označevanje, pri nekaterih urednikih pa moramo namestiti vtičnik za označevanje.
Če želite delati z oznako, datoteko shranite s pripono .md ali .markdown .
Kako dodati naslove v urejevalnik Markdown
Pri označevanju je podprtih 6 stopenj naslova. Če želite ustvariti naslov, uporabite simbol Hash (#) , ki mu sledi presledek in ime naslova. Višja je zgoščena vrednost, manjša je velikost naslova.
OPOMBA: H1 in H2 imata privzeto slog podčrtaja.
# Heading1 ## Heading2 ### Heading3 #### Heading4 ##### Heading5 ###### Heading 6
Včasih boste morda želeli naslov poravnati proti sredini. Toda žalostna zgodba je, da prilagajanje privzeto ne podpira poravnave. Privzeto so naslovi upodobljeni z levo poravnavo. Oznake HTML/CSS lahko vdelate v oznako, da dosežete poravnavo.
<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 komentarje v urejevalnik Markdown
Komentarji so način dokumentiranja nekaterih stvari za boljše razumevanje kode/dokumentov. Tega motor za zmanjševanje ne bo upodobil.
<!-- Comment block -->
Kako upodabljati besedilo v eno vrstico
Običajno, ko vtipkate nekaj v ločene vrstice, bodo oznake prikazane kot ena vrstica.
Prelome vrstic lahko ustvarite na dva načina.
- Prelom mehke črte
- Prekinitev trde povezave
Mehke prelome vrstic lahko ustvarite tako, da na koncu vrstice dodate dva presledka. Tako bodo pri določanju vrednosti vsake vrstice ločene.
Prelome trde vrstice lahko ustvarite tako, da med vsako vrstico vstavite prazno vrstico.
Kako dodati vodoravne črte
Vodoravno pravilo lahko ustvarite tako, da v eno vrstico postavite tri ali več zvezdic (*), vezajev (-) ali podčrtajev (_). Prav tako je v redu, če želite dodati prostor med njimi.
* * * --- ___
Kako narediti krepko besedilo
Če želite, da je beseda ali vrstice POBRO, besedo ali vrstice obkrožite med dvojnimi zvezdicami (**) ali dvojnimi podčrtaji (__) .
**Making this sentence bold using double asterisks.** __Making this sentence bold using double underscore.__
Kako narediti ležeče besedilo
Če želite narediti besede ali vrstice ITALICS, besedo ali vrstice obkrožite med zvezdicami (*) ali posameznimi podčrtaji (_) .
*Making this line to be italicized using asterisks.* _Making this line to be italicized using underscore._
Kako dodati prečrtane črte
Če želite udariti karkoli, morate uporabiti dvojno tildo. Med dvojnimi tildami (~~) obkrožite vse, kar potrebujete.
I am just striking the word ~~Howdy~~. ~~I am striking off the entire line.~~
Kako dodati blok citat
Za blokovne navedke uporabite Več kot simbol (>) .
> Single line blockquote.
Oglejte si, kako je upodobljen spodnji blok citat. Obe vrstici sta upodobljeni v isti vrstici.
> first line > Second line > Third line > Fourth line
Vrnitev vrstice lahko uporabite tako, da na koncu vsake vrstice pustite dva presledka. Tako vsaka vrstica ne bo upodobljena v eni vrstici.
Nadomestne vrstice naj ostanejo prazne, pred katerimi je več kot simbol. Na ta način lahko ustvarite prelom vrstice med vsako vrstico v istem bloku.
> first line > > Second line > > Third line > > Fourth line
Ugnezdene blokovne narekovaje lahko ustvarite tudi tako, da dodate dva večja od simbola (>>) .
Ustvari vstavljeno kodo
Uporabite BACKTICK za izdelavo vrstne kode. Spodnji primer prikazuje, kako ustvariti vrstico kode. Poglejte besedo opombe in readme, ki je bila upodobljena kot vrstna koda.
Markdown is one of the best tools for taking `notes` and creating `readme` files.
Dodaj oznako sintakse bloka kode
Dodajte zavihke ali 4 presledke in postavite kodo, da jo upodobite kot kodni blok. Lahko tudi postavite kodo med tri povratne znake, da bo blok upodobljen kot blok kode. Pomembna lastnost, ki jo je treba tukaj opozoriti, je poudarjanje skladnje. Ko kodo postavite v blok, zanjo ni uporabljena nobena barvna shema.
``` echo "Hello world" ```
Zdaj si oglejte isti primer, barvna shema se uporabi samodejno. To je mogoče, če po treh povratnih znakih dodamo ime programskega jezika, ki bo za kodo uporabil barvno shemo.
```bash echo "Hello world" ```
Vzorčna koda pythona.
```python
def fp():
print("Hello World!!!")
fp()
```
Vzorec poizvedbe SQL.
```sql SELECT MAX(SALARY_EMP) FROM EMPLOYEE_TABLE WHERE SALARY_EMP<(SELECT MAX(SALARY_EMP) FROM EMPLOYEE_TABLE) ```
Ustvarite urejene in neurejene sezname
Elemente lahko razvrstite v urejene sezname in neurejene sezname pri označevanju. Če želite ustvariti razvrščen seznam, dodajte številke, ki jim sledi pika. Zanimiv del, ki ga je treba omeniti tukaj, je, da številka ni nujno zaporedna. Markdown engine je dovolj pameten, da lahko razume, da gre za urejen seznam, tudi če naredimo nesekvenčno naročanje.
V spodnjem primeru lahko vidite, da sem ustvaril razvrščen seznam z nesekvenčnim razvrščanjem (10, 15, 150), vendar ga mehanizem za označevanje upodablja pravilno. Ustvari lahko tudi ugnezdeni seznam, kot je prikazano na sliki.
Če želite ustvariti neurejeni seznam, uporabite znak plus (+) zvezdici (*) ali pomišljaj (-) , čemur sledita presledek in vsebina seznama. Podobno kot urejeni seznam lahko tudi tukaj ustvarite ugnezdeni seznam.
Ustvari seznam opravil
To je posebnost GFM. Ustvarite lahko seznam opravil, kot je prikazano na spodnji sliki. Če želite nalogo označiti kot dokončano, morate med kvadratne oklepaje dodati ‘x’ , kot je prikazano na sliki.
Dodaj povezave v besedilo
Če želite dodati povezavo, sledite spodnji sintaksi.
[Tecmint](https://linux-console.net "The best site for Linux")
Razdelimo skladnjo na 3 dele.
- Besedilo za prikaz - to je besedilo, ki bo postavljeno v kvadratne oklepaje ([Tecmint]).
- Povezava - dejansko povezavo boste postavili v oklepaje.
- Naslov - Ko miškin kazalec premaknete nad besedilo, se prikaže namig za povezavo. Naslov naj bo v narekovajih, kot je prikazano na sliki.
Na spodnji sliki lahko vidite\"Tecmint" je moje prikazno besedilo in ko kliknem, me bo preusmeril na\"linux-console.net".
Povezave lahko ustvarite tudi tako, da jih postavite v kotne oklepaje <> .
Dodajte povezave do slik
Sintaksa slike je podobna dodajanju povezav. Če želite dodati sliko, upoštevajte spodnjo skladnjo.
Razdelimo skladnjo na 3 dele.
- Nadomestno besedilo - nadomestno besedilo bo postavljeno med oglate oklepaje (! [alt-text]). Če je slika pokvarjena ali je ni mogoče naložiti, bo to besedilo prikazano skupaj z lomljenim simbolom.
- Povezava - znotraj oklepajev boste postavili dejansko povezavo do slike.
- Naslov - Ko miškin kazalec premaknete nad sliko, bo prikazano ime slike. Naslov naj bo v narekovajih, kot je prikazano na sliki.
Ustvarite lahko tudi povezavo s slikami. Ko uporabnik klikne sliko, bo preusmerjena na zunanjo povezavo. Sintaksa ostaja enaka z nekaj spremembami. Obkrožite isto sintakso, s katero smo vstavili sliko v oglate oklepaje, ki ji sledi povezava v oklepaju.
[](https://en.wikipedia.org/wiki/Markdown)
Ustvari tabelo
Tabele niso podprte v prvotnem okusu zmanjšanja vrednosti. To je ena od posebnosti, ki prihaja z GFM. Poglejmo, kako sestaviti tabelo postopoma.
Prvi del je ustvariti imena stolpcev. Imena stolpcev lahko ustvarite tako, da jih ločite s cevmi (|) .
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID |
V drugi vrstici uporabite pomišljaje (-) v kombinaciji z dvopičjem (:) . Črtice sporočajo mehanizmu za označevanje, da bo ta upodobljen kot tabela, dvopičje pa se odloči, ali naj bo besedilo poravnano na sredino, levo ali desno.
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID | |:-------------:|:-------------|------------:| :---: ⇒ Center alignment :--- ⇒ Left alignment ---: ⇒ Right alignment
Iz tretje vrstice lahko začnete ustvarjati zapise. Zapisi naj bodo ločeni s črto (|) .
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID | |:-------------:|:-------------|------------:| | Ravi | 30 | 127 | | karthick | 27 | 128 |
Na zgornji sliki lahko vidite, da je tabela pravilno upodobljena. Stolpec 1 je poravnan na sredino, stolpca 2 in 3 sta poravnana levo in desno. Če uporabljate Vscode, lahko za oblikovanje tabele uporabite\"Markdown Table Prettifier".
Ustvarite čustveni simbol
GFM podpira široko paleto emojijev. Oglejte si goljufijo za emoji.
To je to za ta članek. Če imate kakršne koli povratne informacije, jih objavite v oddelku za komentarje.