Wéi mat GitHub Aroma Markdown a Linux ze schaffen
Markdown ass eng Formatéierungssprooch déi fir de Web erstallt gëtt. Den Zweck vum Markdown ass d'Liewe einfach ze maachen wa mir um Internet schreiwen. Mat der Zäit ginn et Github Flavored Markdown (GFM).
Github baséiert op CommonMark. Et gi vill zousätzlech Funktiounen am GFM ënnerstëtzt wéi Dëscher, Code Fechter, etc.. Loosst eis sprangen an d'Syntax fir GFM entdecken a wéi se se a verschiddene Fäll benotzen.
Ech benotzen Atom a Vscode kommen mat Markdown Support a fir e puer Redaktoren musse mir e Markdown Plugin installéieren.
Fir mat Markdown ze schaffen, soll de Fichier mat .md oder .markdown als Extensioun gespäichert ginn.
Wéi Dir Rubriken op Markdown Editor addéiere kënnt
Et gi 6 Niveauen vun der Rubrik ënnerstëtzt am Markdown. Fir eng Rubrik ze kreéieren benotzt den Hash (#) Symbol gefollegt vun engem Raum an den Numm vun der Rubrik. Méi héich den Hashwäert manner d'Gréisst vun der Rubrik.
NOTÉIERT: H1 an H2 wäerten als Standard ënnersträichen.
# Heading1 ## Heading2 ### Heading3 #### Heading4 ##### Heading5 ###### Heading 6
Heiansdo wëllt Dir d'Richtung Richtung Zentrum ausriichten. Awer déi traureg Geschicht ass d'Ausrichtung gëtt net als Standard am Markdown ënnerstëtzt. Par défaut ginn Rubriken mat der lénkser Ausrichtung ofgeleet. Dir kënnt HTML/CSS Tags bannent Markdown embed fir Ausrichtung z'erreechen.
<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>
Wéi füügt Kommentarer un Markdown Editor
Kommentare sinn e Wee fir verschidde Saachen ze dokumentéieren fir e bessert Verständnis vu Code/Dokumenter. Dëst gëtt net vum Markdown-Moteur gemaach.
<!-- Comment block -->
Wéi rendert een Text als eenzeg Linn
Normalerweis wann Dir eppes an getrennten Zeilen een nom aneren schreift, gëtt et als eenzeg Zeil.
Dir kënnt Linn Pausen an zwou Méiglechkeeten schafen.
- Soft Zeilpaus
- Hardline Paus
Soft Zeilpausen kënnen erstallt ginn andeems zwee Plazen um Enn vun der Linn bäigefüügt ginn. Dëse Wee Markdown wäert all Linn als separat Linnen maachen.
Hardline Pausen kënnen erstallt ginn andeems Dir eng eidel Linn tëscht all Zeil setzt.
Wéi Dir horizontal Linnen derbäi
Déi horizontal Regel kann erstallt ginn andeems Dir dräi oder méi Asterisken (*), Bindestrecken (-) oder Ënnersträicher (_) op enger eenzeger Linn setzt. Et ass och ok fir Plaz tëscht hinnen ze addéieren.
* * * --- ___
Wéi een Text fett mécht
Fir d'Wuert oder d'Zeilen BOLD ze maachen, ëmginn d'Wuert oder d'Linnen tëscht duebelen Asterisken (**) oder duebel Ënnersträich (__).
**Making this sentence bold using double asterisks.** __Making this sentence bold using double underscore.__
Wéi een Text Kursiv mécht
Fir Wierder oder Zeilen ITALICS ze maachen, ëmginn d'Wuert oder d'Linnen tëscht eenzelen Asterisken (*) oder eenzel Ënnersträich (_).
*Making this line to be italicized using asterisks.* _Making this line to be italicized using underscore._
Wéi füügt e Strike-Through op Linnen
Fir eppes ze schloen, musst Dir eng duebel Tilde benotzen. Ëmginn alles wat Dir braucht fir tëscht duebel Tilden ze schloen (~~).
I am just striking the word ~~Howdy~~. ~~I am striking off the entire line.~~
Wéi ee Blockquote derbäi
Benotzt Grouss wéi e Symbol (>) fir Blockquote.
> Single line blockquote.
Kuckt wéi d'Blockzitat ënnendrënner gëtt. Souwuel d'Linnen ginn an der selwechter Linn gemaach.
> first line > Second line > Third line > Fourth line
Dir kënnt Linn Retour benotzen vun zwee Plazen um Enn vun all Linn verloosse. Op dës Manéier gëtt all Zeil net an enger eenzeger Linn rendered.
Loosst déi alternativ Linnen eidel mat méi wéi e Symbol Präfix. Op dës Manéier kënnt Dir eng Zeilpaus tëscht all Zeil am selwechte Block erstellen.
> first line > > Second line > > Third line > > Fourth line
Dir kënnt och nestéiert Blockzitater erstellen andeems Dir zwee méi grouss wéi Symboler derbäi (>>).
Erstellt Inline Code
Benotzt BACKTICK fir Inline Code ze maachen. Dat hei ënnendrënner Beispill weist wéi een Inline Code erstellt. Kuckt d'Wuertnotizen a Readme déi als Inline Code ausgezeechent gouf.
Markdown is one of the best tools for taking `notes` and creating `readme` files.
Add Code Block Syntax Highlighting
Füügt Tabs oder 4 Plazen derbäi a setzt Äre Code fir en als Codeblock ze maachen. Alternativ, plazéiert Äre Code tëscht dräi Backticks fir datt de Block als Codeblock renderéiert gëtt. Déi wichteg Feature fir hei ze notéieren ass Syntax Highlight. Normalerweis wann Dir de Code am Block placéiert gëtt et kee Faarfschema ugewannt.
``` echo "Hello world" ```
Kuckt elo datselwecht Beispill, d'Faarfschema gëtt automatesch applizéiert. Dëst ass méiglech andeems de Programméierungssproochnumm no dräi Backticks derbäigesat gëtt, déi de Faarfschema op de Code uwenden.
```bash echo "Hello world" ```
Beispill Python Code.
```python
def fp():
print("Hello World!!!")
fp()
```
Beispill SQL Ufro.
```sql SELECT MAX(SALARY_EMP) FROM EMPLOYEE_TABLE WHERE SALARY_EMP<(SELECT MAX(SALARY_EMP) FROM EMPLOYEE_TABLE) ```
Erstellt bestallt an net bestallt Lëschte
Artikele kënnen an bestallte Lëschte an onorderéierte Lëschten am Markdown organiséiert ginn. Fir eng bestallt Lëscht ze kreéieren, addéiere Zuelen gefollegt vun enger Period. Den interessanten Deel fir hei ze notéieren ass d'Zuel muss net sequenziell sinn. Markdown Motor ass intelligent genuch fir ze verstoen datt et eng bestallt Lëscht ass och wa mir déi net-sequenziell Bestellung maachen.
Am Beispill hei ënnen, kënnt Dir gesinn datt ech eng bestallt Lëscht mat net-sequenziellen Uerdnung erstallt hunn (10, 15, 150) awer de Markdownmotor mécht et an der korrekter Uerdnung. Dir kënnt och eng nestéiert Lëscht erstellen wéi am Bild gewisen.
Fir eng ongeuerdente Lëscht ze kreéieren benotzt Plus Zeechen (+) Asterisken (*) oder Bindestrich (-) gefollegt vun engem Raum an Inhalt vun der Lëscht. Ähnlech wéi déi bestallt Lëscht kënnt Dir och hei eng nestéiert Lëscht erstellen.
Erstelle Aufgab Lëscht
Dëst ass eng speziell Feature vu GFM. Dir kënnt eng Tasklëscht erstellen wéi am Bild hei ënnen. Fir d'Aufgab als fäerdeg ze markéieren, musst Dir 'x' tëscht quadrateschen Klameren addéieren wéi am Bild gewisen.
Füügt Linken op Text
Fir e Link ze addéieren, befollegt d'Syntax hei ënnen.
[Tecmint](https://linux-console.net "The best site for Linux")
Loosst eis d'Syntax an 3 Deeler opbriechen.
- Text fir ze weisen - Dëst ass den Text deen a véiereckege Klameren gesat gëtt ([Tecmint]).
- Link - Dir wäert den eigentleche Link an de Klammern placéieren.
- Titel - Wann Dir Är Maus iwwer den Text hovert, weist en Tooltip fir de Link. Den Titel soll bannent Zitaten gesat ginn, wéi am Bild gewisen.
Aus dem Bild hei drënner kënnt Dir Tecmint gesinn ass mäi Displaytext a wann ech klickt, wäert et mech op linux-console.net redirectéieren.
Dir kënnt och Linken erstellen andeems Dir se an de Wénkelklammern setzt < >.
Füügt Links op Biller
D'Syntax fir d'Bild gesäit ähnlech aus wéi d'Links addéieren. Fir e Bild ze addéieren, befollegt d'Syntax hei ënnen.
Loosst eis d'Syntax an 3 Deeler opbriechen.
- Alternativ Text - Alternativ Text gëtt tëscht de Klammern (![alt-Text]) gesat. Wann e Bild futti ass oder net fäeg ass ze lueden, gëtt dësen Text zesumme mat engem futtis Symbol ugewisen.
- Link - An de Klammern setzt Dir den aktuellen Link op d'Bild.
- Titel - Wann Dir Är Maus iwwer d'Bild hovert, weist se den Numm vum Bild. Den Titel soll bannent Zitaten gesat ginn, wéi am Bild gewisen.
Dir kënnt och e Link mat Biller erstellen. Wann e Benotzer op d'Bild klickt, gëtt et op en externe Link ëmgeleet. D'Syntax bleift d'selwecht mat e puer Ännerungen. Ëmginn déiselwecht Syntax déi mir benotzt hunn fir e Bild a véiereckege Klammeren anzeginn, gefollegt vun engem Link an der Klammern.
[](https://en.wikipedia.org/wiki/Markdown)
Erstellt en Dësch
Dëscher sinn net am Original Goût vun markdown ënnerstëtzt. Et ass eng vun de spezielle Funktiounen déi mat GFM kommen. Loosst eis kucken wéi en Dësch op eng Schrëtt-fir-Schrëtt Manéier bauen.
Den éischten Deel ass Spaltennimm ze kreéieren. Kolonnenimm kënnen erstallt ginn andeems se se mat Päifen trennen (|).
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID |
Op der zweeter Linn benotzt Bindestricher (-) a Kombinatioun mat engem Colon (:). Dashes soen dem Markdown-Moteur datt dëst als Tabelle gëtt an de Colon entscheet ob eisen Text am Zentrum, lénks oder riets ausgeriicht soll sinn.
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID | |:-------------:|:-------------|------------:| :---: ⇒ Center alignment :--- ⇒ Left alignment ---: ⇒ Right alignment
Vun der drëtter Linn kënnt Dir ufänken records ze kreéieren. Opzeechnunge solle vun engem Päif getrennt ginn (|).
| EMPLOYEE_NAME | EMPLOYEE_AGE | EMPLOYEE_ID | |:-------------:|:-------------|------------:| | Ravi | 30 | 127 | | karthick | 27 | 128 |
Aus dem uewe Bild kënnt Dir gesinn datt d'Tabell richteg gemaach gëtt. Kolonn 1 ass zentral ausgeriicht, Kolonnen 2 an 3 si lénks a riets ausgeriicht. Wann Dir Vscode benotzt, kënnt Dir Markdown Table Prettifier benotzen fir den Dësch ordentlech ze formatéieren.
Erstellt en Emoji
GFM ënnerstëtzt eng breet Palette vun Emojis. Kuckt d'Emoji Cheat Sheet.
Dat ass et fir dësen Artikel. Wann Dir e Feedback hutt, post et w.e.g. an de Kommentarsektioun.