Kif taħdem ma 'Markdown bit-togħma ta' GitHub fil-Linux
Markdown hija lingwa tal-ifformattjar li hija maħluqa għall-web. L-iskop tal-markdown huwa li tagħmel il-ħajja faċli meta nkunu qed niktbu fuq l-internet. Maż-żmien hemm Github Flavored Markdown (GFM).
Github huwa bbażat fuq CommonMark. Hemm ħafna karatteristiċi addizzjonali appoġġjati fil-GFM bħal tabelli, fencing tal-kodiċi, eċċ. Ejja naqbżu u nesploraw is-sintassi għal GFM u kif tużaha f'każijiet differenti.
Qed nuża Atom u Vscode jiġu b'appoġġ ta 'markdown u għal xi edituri, għandna bżonn ninstallaw plugin markdown.
Biex taħdem b'markdown il-fajl għandu jiġi ffrankat b'.md
jew .markdown
bħala estensjoni.
Kif Żid Intestaturi mal-Editur Markdown
Hemm 6 livelli ta' intestatura appoġġjati f'markdown. Biex toħloq intestatura uża s-simbolu Hash (#)
segwit minn spazju u isem tal-intestatura. Ogħla l-valur tal-hash inaqqas id-daqs tal-intestatura.
NOTA: H1 u H2 se jkollhom stil issottolinjat awtomatikament.
# Heading1 ## Heading2 ### Heading3 #### Heading4 ##### Heading5 ###### Heading 6
Xi drabi tista 'tixtieq li tallinja l-intestatura lejn iċ-ċentru. Iżda l-istorja diqa hija l-allinjament mhuwiex appoġġjat awtomatikament fil-markdown. B'mod awtomatiku, l-intestaturi huma mogħtija b'allinjament tax-xellug. Tista' tiddaħħal tags HTML/CSS fi ħdan markdown biex tikseb l-allinjament.
<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>
Kif Żid Kummenti mal-Editur Markdown
Il-kummenti huma mod biex jiddokumentaw ċerti affarijiet għal fehim aħjar tal-kodiċi/Dokumenti. Dan mhux se jsir mill-magna tal-markdown.
<!-- Comment block -->
Kif tirrendi t-test bħala linja waħda
Normalment meta ttajpja xi ħaġa f'linji separati wieħed wara l-ieħor, il-markdown jagħtiha bħala linja waħda.
Tista 'toħloq line breaks f'żewġ modi.
- Qasam tal-linja artab
- Hardline waqfa
Jistgħu jinħolqu waqfiet tal-linja artab billi jiżdiedu żewġ spazji fit-tarf tal-linja. Dan il-mod markdown se jirrendi kull linja tkun linji separati.
Jistgħu jinħolqu waqfiet hardline billi tiddaħħal linja vojta bejn kull linja.
Kif Żid Linji Orizzontali
Ir-regola orizzontali tista' tinħoloq billi tpoġġi tliet asterisks (*) jew aktar, sings(-), jew linji ta' taħt (_) fuq linja waħda. Huwa wkoll ok li żżid spazju bejniethom.
* * * --- ___
Kif Tagħmel Test Bold
Biex tagħmel il-kelma jew il-linji BOLD, iddawwar il-kelma jew il-linji bejn asterisks doppji (**)
jew linja taħt doppja (__)
.
**Making this sentence bold using double asterisks.** __Making this sentence bold using double underscore.__
Kif Tagħmel Test Korsiv
Biex tagħmel kliem jew linji KORSSIVI, iddawwar il-kelma jew linji bejn asterisks singoli (*)
jew linja taħt linja waħda (_)
.
*Making this line to be italicized using asterisks.* _Making this line to be italicized using underscore._
Kif Żid Strike-Through mal-Linji
Biex tolqot xi ħaġa trid tuża tilde doppja. Jidawwar dak kollu li għandek bżonn biex tolqot bejn tildes doppji (~~)
.
I am just striking the word ~~Howdy~~. ~~I am striking off the entire line.~~
Kif Żid Blockquote
Uża Ikbar minn simbolu (>)
għal blockquote.
> Single line blockquote.
Ara kif tingħata l-kwotazzjoni tal-blokk hawn taħt. Iż-żewġ linji huma mogħtija fl-istess linja.
> first line > Second line > Third line > Fourth line
Tista' tuża ritorn tal-linja billi tħalli żewġ spazji fl-aħħar ta' kull linja. B'dan il-mod kull linja mhux se tkun mogħtija f'linja waħda.
Ħalli l-linji alternattivi vojta prefissati b'akbar minn simbolu. Dan il-mod tista 'toħloq waqfa tal-linja bejn kull linja fl-istess blokk.
> first line > > Second line > > Third line > > Fourth line
Tista 'wkoll toħloq kwotazzjonijiet ta' blokk imnaqqxa billi żżid tnejn akbar minn simboli (>>)
.
Oħloq Kodiċi Inline
Uża BACKTICK biex tagħmel kodiċi inline. L-eżempju hawn taħt juri kif toħloq kodiċi inline. Ħares lejn il-kelma noti u readme li ġiet mogħtija bħala kodiċi inline.
Markdown is one of the best tools for taking `notes` and creating `readme` files.
Żid Is-Sintassi tal-Blokk tal-Kodiċi
Żid tabs jew 4 spazji u poġġi l-kodiċi tiegħek biex tirrendih bħala blokka tal-kodiċi. Inkella, poġġi l-kodiċi tiegħek bejn tliet backticks biex tagħmel il-blokk li jkun ipprovdut bħala blokk tal-kodiċi. Il-karatteristika importanti li għandha tiġi nnutata hawnhekk hija l-enfasi tas-sintassi. Normalment meta tpoġġi l-kodiċi fi ħdan il-blokka m'hemm l-ebda skema ta 'kulur applikata għaliha.
``` echo "Hello world" ```
Issa ħares lejn l-istess eżempju, l-iskema tal-kulur hija applikata awtomatikament. Dan huwa possibbli billi żżid l-isem tal-lingwa ta 'programmar wara tliet backticks li se japplikaw l-iskema tal-kulur għall-kodiċi.
```bash echo "Hello world" ```
Kodiċi python tal-kampjun.
```python def fp(): print("Hello World!!!") fp() ```
Kampjun ta' mistoqsija SQL.
```sql SELECT MAX(SALARY_EMP) FROM EMPLOYEE_TABLE WHERE SALARY_EMP<(SELECT MAX(SALARY_EMP) FROM EMPLOYEE_TABLE) ```
Oħloq Listi Ordnati u Mhux Ordnati
L-oġġetti jistgħu jiġu organizzati f'listi ordnati u listi mhux ordnati f'markdown. Biex toħloq lista ordnata, żid in-numri segwiti minn punt. Il-parti interessanti li wieħed jinnota hawnhekk hija n-numru m'għandux għalfejn ikun sekwenzjali. Il-magna Markdown hija intelliġenti biżżejjed biex tifhem li hija lista ordnata anke jekk nagħmlu l-ordni mhux sekwenzjali.
Fl-eżempju ta 'hawn taħt, tista' tara li ħloqt lista ordnata b'ordni mhux sekwenzjali (10, 15, 150) iżda l-magna ta 'markdown tirrendiha f'ordni xierqa. Tista 'wkoll toħloq lista nested kif muri fl-immaġini.
Biex toħloq lista mhux ordnata uża sinjal plus (+)
asterisks (*)
jew sing (-)
segwit bi spazju u kontenut tal-lista. Simili għal-lista ordnata tista 'toħloq lista nested hawn ukoll.
Oħloq Lista tal-Kompitu
Din hija karatteristika speċjali tal-GFM. Tista 'toħloq lista ta' kompiti kif muri fl-immaġni hawn taħt. Biex timmarka l-kompitu bħala lest, trid iżżid ‘x’
bejn ċineg kwadri kif muri fl-immaġini.
Żid Links mat-Test
Biex iżżid link, segwi s-sintassi hawn taħt.
[Tecmint](https://linux-console.net "The best site for Linux")
Ejja nkissru s-sintassi fi 3 partijiet.
- Test li għandu jintwera – Dan huwa t-test li se jitqiegħed ġewwa ċingi kwadri ([Tecmint]).
- Link – inti tpoġġi l-link attwali ġewwa l-parentesi.
- Titolu – Meta tgħaddi l-maws fuq it-test se juri tooltip għall-link. It-titlu għandu jitqiegħed fi ħdan il-kwotazzjonijiet kif muri fl-immaġini.
Mill-immaġini ta' hawn taħt tista' tara \Tecmint huwa t-test tal-wiri tiegħi u meta nikklikkja li se terġa' tidderieġi lejn \linux-console.net.
Tista' wkoll toħloq links billi tpoġġihom ġewwa parentesi angolari < >
.
Żid Links għal Stampi
Is-sintassi għall-immaġni tidher simili għaż-żieda ta 'links. Biex iżżid immaġini, segwi s-sintassi hawn taħt.
![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")
Ejja nkissru s-sintassi fi 3 partijiet.
- Test alternattiv – It-test alternattiv jitqiegħed bejn parentesi kwadri (![alt-text]). Jekk immaġni tinkiser jew ma tkunx tista' tagħbija dan it-test jintwera flimkien ma' simbolu miksur.
- Link – Ġewwa l-parentesi, int se tpoġġi l-link attwali għall-immaġni.
- Titolu – Meta tpoġġi l-maws fuq l-immaġini dan juri l-isem tal-immaġni. It-titlu għandu jitqiegħed fi ħdan il-kwotazzjonijiet kif muri fl-immaġini.
Tista 'wkoll toħloq rabta ma' stampi. Meta utent jikklikkja l-immaġini din tiġi ridiretta lejn link estern. Is-sintassi tibqa' l-istess bi ftit modifiki. Dawwar l-istess sintassi li użajna biex daħħal immaġini fil-parentesi kwadri segwita minn link ġewwa l-parentesi.
[![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)
Oħloq Tabella
It-tabelli mhumiex appoġġjati fit-togħma oriġinali ta 'markdown. Hija waħda mill-karatteristiċi speċjali li jiġu mal-GFM. Ejja naraw kif tibni tabella b'mod pass pass.
L-ewwel parti hija li toħloq ismijiet tal-kolonni. L-ismijiet tal-kolonni jistgħu jinħolqu billi jiġu separati b'pajpijiet (|)
.
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID |
Fit-tieni linja, uża sing (-)
flimkien ma' kolon (:)
. Dashes jgħidu lill-magna tal-markdown li din għandha tiġi mogħtija bħala tabella u l-kolon jiddeċiedi jekk it-test tagħna għandux ikun allinjat fiċ-ċentru, ix-xellug jew il-lemin.
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID | |:-------------:|:-------------|------------:| :---: ⇒ Center alignment :--- ⇒ Left alignment ---: ⇒ Right alignment
Mit-tielet linja, tista 'tibda toħloq rekords. Ir-rekords għandhom ikunu separati b'pajp (|)
.
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID | |:-------------:|:-------------|------------:| | Ravi | 30 | 127 | | karthick | 27 | 128 |
Mill-immaġni ta 'hawn fuq, tista' tara li t-tabella hija mogħtija kif suppost. Il-kolonna 1 hija allinjata ċ-ċentru, il-kolonni 2 u 3 huma allinjati lejn ix-xellug u mal-lemin. Jekk qed tuża Vscode, tista' tuża \Markdown Table Prettifier biex tifformattja t-tabella b'mod pulit.
Oħloq Emoji
GFM jappoġġja firxa wiesgħa ta 'emojis. Agħti ħarsa lejn l-emoji cheat sheet.
Dak hu għal dan l-artikolu. Jekk għandek xi feedback jekk jogħġbok ibgħatha fit-taqsima tal-kummenti.