Për të mbajtur shënime në një kompjuter, shumë prej nesh e njohin atë tipike: Word ose LibreOffice Writer. Është një opsion i mirë për disa skenarë, por nëse ajo që duam është të mbajmë shënime, ta bëjmë shpejt, t'i kemi në një format të caktuar dhe ta hapim me një shikues jo shumë të rëndë, ndoshta është më mirë të përdorim atë që njihet si Markdown. Këtu do të shpjegojmë se çfarë është, si "shënohet" teksti dhe do të përmendim disa redaktorë/shikues që janë të vlefshëm në Linux.
Markdown është një shënim i lehtë, objektivi i të cilit është të maksimizojë lexueshmërinë dhe lehtësinë e publikimit, si në formën e tij hyrëse dhe dalëse. Ashtu si HTML, Markdown shfaq tekstin në mënyra të ndryshme në varësi të shënimit që përdorim në të, të tilla si shkronja të zeza dhe kursive. Ai u krijua nga John Gruber dhe i ndjeri Aaron Swartz, dhe pa shkuar më tej në historinë e tij, ne do të shpjegojmë se si ta përdorim atë.
Si të krijoni dokumente Markdown
Krijimi i një dokumenti Markdown është diçka që ne mund ta bëjmë atë me çdo redaktues teksti të thjeshtë. Kjo është e njëjta gjë në HTML, por Markdown është më e lehtë për t'u shkruar. HTML përdor etiketat hyrëse dhe dalëse, dhe në të gjitha rastet ato kanë simbole më pak se (), gjë që nuk është më e rehatshme për të shkruar, të paktën në një tastierë spanjolle. Shumë nga shenjat që do të përdorim në Markdown gjithashtu duhet të vendosen para dhe pas çdo fjale, por përdorimi i dy yjeve nuk është i njëjtë me simbolet që përdor HTML. E vetmja gjë që ju nevojitet, përveç shënimeve, është të ruani skedarin me shtesën .md ose .markdown.
Markdown Nuk ka aq shumë opsione sa HTML, por as ai nuk e ka ndërmend. Ka disa që mund t'i gjejmë në internet që mund të mos mbështeten nga një shikues dokumentesh i pajtueshëm me Markdown, por ato më të përdorurat janë, dhe ato janë këto:
Hapësirat në Markdown
Nuk do të doja ta filloja apo ta mbyllja artikullin pa këtë seksion. Dhe në disa marka, si ato për titujt ose listat, duhet të vendosni një hapësirë midis simbolit dhe tekstit. Mund të marrim rezultatin e pritur pa këto hapësira, por kjo përmirëson lexueshmërinë dhe konsiderohet praktikë e mirë.
Titujt e titullit
Në HTML ato njihen si h1-h6. Semantikisht, ato duhet të përdoren si përbërës të një indeksi; Ju nuk keni nevojë t'i përdorni ato për të vendosur tekst më të madh ose më të vogël. Në teori, h1 duhet të jetë vetëm titulli i një faqeje, h2 janë pjesë e h1, h3 janë pjesë e një h2 e kështu me radhë. Për shembull, "Si të krijoni dokumente Markdown" në këtë artikull është një h2 që është brenda artikullit të përgjithshëm me h1, dhe "Titujt e titullit" dhe ajo që do të pasojë do të jetë h3 që janë pjesë e seksionit se si janë krijuar.
Në HTML etiketa do të ishte TEXT, ndërsa në Markdown është me dy shenja hash përpara:
## Kjo do të ishte një h2
Numri i jasteve tregon numrin e kokës, maksimumi është 6.
Bold, italic, strofull dhe theksuar
Tekstet me shkronja të zeza (b o i fortë në HTML) dhe kursive (i o em në HTML) duken shumë të ngjashme, aq sa mund të jetë konfuze. mund të vihet tekst me shkronja të zeza që e rrethon me dy nënvizime, dhe me shkronja të pjerrëta me një nënvizim në secilën anë. Prandaj, tre nënvizime do ta bënin tekstin të trashë dhe të pjerrët. Dhe saktësisht e njëjta gjë me yjet.
Për të shmangur konfuzionin, unë do të rekomandoja përdorimin e një nënvizimi për shkronjat e pjerrëta dhe dy yjet për të theksuara:
shkronja të theksuara _kursive_
Mund të mos mbështetet në disa shikues, por mund ta kryqëzoni tekstin duke vendosur mustaqet Ñ përpara dhe pas tij dy herë (~~) dhe ta theksoni si me një shënues me dy simbole të barabarta përpara dhe pas tij (==) .
~~I goditur ~~ ==E theksuar==
Unë nuk e shoh atë të theksuar në VSCode ose në disa shikues Linux, por e shoh atë në shënimet e shfletuesit Vivaldi.
Nëse po pyesni se si të nënvizoni, ajo nuk ekziston në Markdown, çuditërisht. Nëse keni nevojë të nënvizoni tekstin, është më mirë të përdorni etiketën HTML teksti i nënvizuar.
Fuqia dhe nënshkrimi
Nëse duam të vendosim një numër i ngritur në një tjetër, që është fuqia, mund të bëhet duke vendosur numrin e parë, të ndjekur nga rrethi (^) dhe më pas fuqia: 2^4 do të tregonte 2⁴. Ka mënyra për të vendosur numrin në anën e kundërt (nënshkrimin), por si teksti i shënuesit, ai nuk mbështetet nga të gjithë procesorët. Ajo arrihet me një mustaqe të Ñ në secilën anë të tekstit ose numrit: h~2~ose duket h2ose (nëse nuk shihet, imagjinoni që 2 është më e ulët).
Paragrafët
zakonisht nuk ka nevojë të përdorni ndonjë shënim për paragrafët, por ju duhet të dini disa gjëra. Ata kanë atë që njihet si një pushim i vështirë, dhe në fillim nuk mund të vendosni tekst si më poshtë, i cili do të shihet në një poezi:
Një ditë në janar (hapësirë) (hapësirë) Duket si një ditë e mirë (hapësirë) (hapësirë) Poezi e jashtëzakonshme (hapësirë) Blogeri shkroi (hapësirë) (hapësirë)
Në tekstin e mëparshëm, Markdown vendos gjithçka në një rresht, por mashtrimi është të vendosni dy hapësira në fund të çdo rreshti. Në këtë mënyrë ajo respekton atë që ne kërkojmë. Përndryshe, mund të shtoni një vijë të prapme, dhe rekomandohet nëse dëshironi të vendosni blloqe rreshtash me të njëjtin format (të theksuara, të pjerrëta...) me vetëm dy simbole në fillim dhe dy në fund të të gjithë bllokut.
listat
Në HTML ekzistojnë të paktën tre lloje listash, të renditura (me numra përpara), të pa renditura (pika përpara) dhe përkufizime, ol, ul y dl përkatësisht në HTML. Në Markdown kemi të njëjtën gjë, dhe ato do të krijoheshin si kjo:
Listat e pa renditura
Me një vizë përpara:
- Elementi i parë - Elementi i dytë - Elementi i tretë
dhe gjithashtu me një yll:
*Kjo do të shkonte së pari * Kjo sekondë * Dhe e treta
ose simbolet shtesë:
+ Pika e parë + Pika e dytë + Pika e tretë
Nëse duam të krijojmë një nënlistë, do të vendosim dy nga simbolet e mëparshme në vend të një, tre për një nën-listë e kështu me radhë.
- Blini - - Qumësht - - Biskota
Mund të bëhet edhe me dhëmbëzim (disa hapësira bosh).
Listat e renditura
Listat e renditura krijohen duke vendosur një numër të ndjekur nga një pikë dhe më pas elementin:
1. Gjëja e parë 2. Kjo vijon 3. Dhe kjo më vonë
Ose edhe me një kllapa në vend të pikës:
1) Elementi 1 2) Elementi 2
Për të shtuar nënlista, duhet të shtoni dhëmbëzimin, në varësi të nivelit që duam të arrijmë. Gjëja e zakonshme është 4 hapësira bosh ose çfarëdo që jep tasti tab (nëse shtypja e lëviz kursorin në të djathtë). Në shembullin e mëposhtëm, Përgatitja dhe Instalimi janë në anën e majtë, ndërsa pikat e ndërmjetme janë katër hapësira përpara:
1. Përgatitja: 1. ISO është shkarkuar. 2. Është regjistruar në një USB. 2. Instalimi: 1. USB-ja futet në pajisje. 2. Ajo...
Do të dukej si:
- Përgatitja:
- ISO është shkarkuar.
- Është regjistruar në një USB.
- instalimit:
- USB-ja futet në pajisje.
- AI..
Mbani në mend se listat e renditura në Markdown ndjekin gjithmonë një renditje, e thënë kurrë më mirë. Mund të krijohet me 1., 1., 1. dhe do të shihni 1., 2., 3.. Për t'i thyer ato duhet të shtoni tekst në mes me një ndërprerje të dyfishtë rreshti. Dhe edhe kështu, nëse më pas vendosni 2., do të vazhdojë me numërimin.
Listat e të dhënave
Listat e të dhënave janë ato në të cilat një term pasohet nga një përkufizim dhe mund të krijohen si kjo (nuk mbështetet nga shumë shikues):
Termi 1 : Përkufizimi 1 Termi 2 : Përkufizimi 2a : Përkufizimi 2b
Lista e detyrave
Ju mund të krijoni lista detyrash me një simbol të listës së parregulluar ('-', '*' ose '+'), hapësirë dhe kllapa katrore. Nëse janë me një hapësirë boshe, detyra mbetet për t'u bërë; me një "x" brenda, bëhet:
- [ ] Krijo artikull - [x] Urime vitin e ri
Do të dukej si:
- Krijoni artikull
- Urime vitin e ri
Listat mund të kombinohen dhe këtu futen në lojë imagjinata dhe nevojat e secilit.
Lidhjet në Markdown
Ka disa mënyra për të shtuar lidhje në Markdown: të shpejta ose të drejtpërdrejta, normale dhe me referencë. E shpejta është shtoni lidhjen siç është, me protokollin e përfshirë. Për shembull, https://linuxadictos.com do të shihet si një lidhje e klikueshme në shumicën e shikuesve të pajtueshëm me Markdown. Pastaj kemi normalen e këtij lloji të gjuhës dhe me referencë.
Lidhja normale vendoset me tekstin në kllapa katrore dhe lidhjen dhe të saj titull o tooltip (nëse ekziston, në thonjëza) në kllapa:
[Blogu më i mirë Linux](https://linuxadictos.com "Ose ne përpiqemi")
Lidhjet sipas referencës janë pak më të ndërlikuara, por mund të jenë të dobishme sepse nëse duhet të bëjmë ndryshime, modifikimi i referencës do të modifikojë të gjitha lidhjet që e përdorin atë. Sintaksa është e ngjashme, por teksti do të vendoset në kllapa katrore i ndjekur nga referenca në kllapa të tjera katrore. Referenca tregohet më poshtë. Më mirë me një shembull sesa me një mijë fjalë:
[Blogu më i mirë Linux][LXA] ... ... ... [LXA]: https://linuxadictos.com
Referencat zakonisht vendosen në fund të dokumentit.
Nëse duam që një lidhje të shfaqet pa hiperlidhje, mund ta rrethojmë me thekse të pasme ose të hapura (`), që është një metodë ikjeje për të cilën do të flasim më vonë. Do t'i japë njëfarë formatimi, por nuk do të lidhet me asgjë.
Lidhje me ID
Markdown gjithashtu ju lejon të krijoni lidhje me elementet me ID. Mënyra e parë për ta bërë këtë është ajo që ndahet më së shumti, por nuk ka funksionuar kurrë për mua: {#el-id} duhet të shtohet në kokë, prapa dhe lidhja, në vend të një URL, duhet të përfshijë ID-në. Për shembull, [tek imazhet](#imazhe) do të çonte në pikën tjetër nëse Markdown-i juaj ishte “## Imazhe në Markdown {#imazhe}”.
Ka dy mënyra të tjera për të shtuar lidhje në ID:
- Lidhje me titujt automatikë: Disa përpunues teksti dhe disa shikues e mbështesin atë, shtojnë ID-në automatikisht. Nëse titulli është "A test", ID-ja është e njëjtë, por të gjitha me shkronja të vogla dhe duke zëvendësuar hapësirat me viza. Sintaksa duhet të jetë:
[Teksti që duam të shfaqë](#a-test)
- Lidhje me HTML ID: kjo metodë është duke shtuar një etiketë (të tilla si një "a", por nuk është e detyrueshme) me ID-në e dëshiruar, dhe pa asnjë tekst midis etiketave hapëse dhe mbyllëse në mënyrë që të veprojë vetëm si referencë (). Lidhja do të ishte saktësisht e njëjtë si në pikën e mëparshme.
Nëse ajo që kërkojmë është të kthehemi në krye të dokumentit, mjafton të vendosim shenjën hash midis kllapave.
Një truk estetik: nëse shtojmë diku në kod <style>* {scroll-behavior: smooth}</style>
, do të shohim zhvendosjen; nuk do të kërcejë. Problemi me këtë është diçka që do ta shpjegoj më vonë: disa fusha mund ta tregojnë atë linjë siç është në vend që ta fshehin.
Imazhet në Markdown
Nëse e keni kuptuar pikën e mëparshme, do ta kuptoni edhe këtë. Imazhet shtohen pothuajse njësoj si lidhjet, me ndryshimin kryesor se para saj vendoset pikëçuditja. Për shembull:

Nga sa më sipër:
- ! tregon se është një imazh.
- [] Ato përmbajnë tekstin alternativ, atributin "alt" të HTML.
- () Ato përmbajnë lidhjen me imazhin, atributin HTML "src".
- Tekstin informativ, "titull" në HTML, mund ta vendosni midis thonjëzave. Nuk ka nevojë.
Nëse duam që imazhi të çojë në një faqe tjetër, e cila është një imazh me një lidhje, gjithçka që duhet të bëjmë është të rrethojmë sa më sipër në kllapa katrore dhe të shtojmë lidhjen pas saj në kllapa.
[](https://duckduckgo.com)
Ashtu si me hiperlidhjet, lidhjet mund të shtohen me referencë, por në referencat e imazheve ato fillojnë me pikëçuditjen.
Dating
Citimet në Markdown krijohen duke filluar një paragraf me simbolin më të madh se, për shembull, Pablinux tha:
> Mendoj, atëherë... Kur e hani?
Do të tregonte:
Unë mendoj, atëherë... Kur e hani atë?
Nëse do të kishim nevojë të vendosnim thonjëza, do të përdoreshin më shumë se simbole.
> Citat origjinal > >> Çfarë u përmend në citat
Do të dukej si:
Citat origjinal
Ajo që u përmend në citat
Dhe nëse duam që citati të përfshijë rreshta bosh, secila prej tyre duhet të përfshijë simbolin përpara tyre, duke përfshirë ato që janë bosh:
> Fraza e parë e mprehtë > > Fundi i takimit
do të tregonte:
Fraza e parë e mprehtë
Fundi i citatit.
Kod
Kodi shtohet me një skedë ose katër hapësira bosh përpara tij:
(tab)sudo pacman -Syu
Nëse vendosni tre thekse varri dhe emrin pas tyre, disa shikues do të tregojnë kodin me ngjyra të veçanta, madje edhe emri i gjuhës do të shfaqet në disa shikues.
```python def test (): Përshëndetje ```
Do të tregonte diçka si kjo:
Linjat horizontale
Vijat horizontale në Markdown mund të krijohen duke lënë vetëm 3 ose më shumë yje (***), viza (—), ose nënvizime (___) në një rresht. Rezultati është si më poshtë:
barazim
Tabelat në Markdown krijohen kryesisht duke vizatuar një fotografi të tyre:
|E para|E dyta|E treta| |:------|:------:|------:| |Fusha e parë|Fusha e dytë|Fusha e tretë| |Diçka|Diçka 2|Diçka 3|
Do të shfaqet (por në një format tjetër):
I parë | I dytë | E treta |
---|---|---|
Fusha e parë | Fusha e dytë | Fusha e tretë |
algo | Diçka 2 | Diçka 3 |
Nuk ka rëndësi se çfarë madhësie lëmë në qeliza.; gjuha do t'i formatojë ato. Në rreshtin e dytë, ndoshta më i rëndësishmi, mund të tregojmë se teksti është rreshtuar në të majtë, në qendër ose në të djathtë. Dy pika (:) tregon se ku shkon teksti, në të kundërtën kur duam ta vendosim në qendër, duhet të vendosim dy pika përpara dhe pas rreshtave.
Formulat matematikore
Markdown gjithashtu ju lejon të shtoni formula matematikore. Për shembull, mund të përfshini një ekuacion online me shenjën e dollarit përpara dhe pas tij: $x2+y2=z^2$. Gjithashtu blloqe me dy dollarë:
$$\sum_{i=0}^ni^2 = \frac{(n^2+n)(2n+1)}{6}$$
Rezultati i sa më sipër duket kështu në VSCode (me një kllapa përpara n-së së dytë, të cilën e humba):
Shpëtimi i personazheve në Markdown
Ndonjëherë mund të jetë e nevojshme të “shpëtojnë” disa personazhe. Për shembull, nëse vendosim # në fillim të një rreshti dhe më pas një hapësirë, ai do të krijojë një h1. Ne mund ta shmangim këtë duke vendosur vijën e prapme përpara, si kjo:
\# Titulli
Dhe kështu do të dilte siç është, pa formatim dhe pa simbolin e arratisjes. Ka disa mënyra të tjera, por kjo është më e përdorura dhe është e njëjtë me gjuhët e tjera.
Shënimi me HTML
Markdown mbështet pjesërisht etiketat HTML dhe rregullat CSS, por unë nuk do të vë bast për këtë. Jo të gjithë shikuesit i tregojnë gjërat njësoj dhe është e rëndësishme ta mbani parasysh këtë. Për shembull, nëse përdorim GitHub Markdown dhe duam të rreshtojmë një imazh, duke përdorur <img align="left">
Ne do ta bëjmë atë të "noton" - lundrues do të thotë që ajo që është poshtë ngrihet dhe vendoset pranë saj - në të majtë. Mund të vendoset në anën e kundërt duke përdorur right
, por opsioni qendror nuk funksionon nëse nuk është i mbështjellë në një etiketë bllok si ose .
Por mund të jetë një opsion. Nëse duam të vendosim tekstin me të kuqe, mund të tërheqim HTML dhe CSS, ta rrethojmë me një enë të tipit span dhe, në linjë (brenda etiketës), të shtojmë rregullat CSS në atributin "style". Mund të jetë e dobishme, për shembull, nëse duam të kontrollojmë madhësinë e një imazhi, por siç thashë, nuk funksionon gjithmonë.
Kur NUK duhet përdorur Markdown
Markdown është ajo që është, dhe është krijuar për të krijuar përmbajtje shpejt dhe për një përdorim shumë specifik. Mund të përdoret për shënime personale ose si një paraprocesor HTML, por Nuk duhet ta përdorni nëse duhet të punoni në një grup që nuk e përdor. Më e përhapura është përdorimi i përpunuesve të tekstit, më konkretisht Word dhe .docx i tij, kështu që nuk do të përdor Markdown nëse planifikoj të ndaj punën time. Ata ndoshta nuk dinë as si t'i shohin ato, përveç nëse u japim lidhjen e një artikulli si ky ;)
Redaktorët Markdown për Linux
Ky artikull ka qenë më i gjatë se sa pritej dhe ndoshta ia vlen ta lini këtë për një postim tjetër. Ndoshta do të ishte një ide e mirë të përmendim disa kalimthi, si p.sh Joplin, Apostrofi ose Visual Studio Code për ata që duan të kenë gjithçka në një vend. Ashtu si shikuesit, disa shikues të parazgjedhur të dokumenteve mund të shfaqin përmbajtjen e tyre.
Çfarëdo që të zgjidhni, ia vlen të përdorni Markdown për shënime personale. Provojeni dhe do më tregoni.
Tabela përmbledhëse
objektiv | Sintaksë |
---|---|
Titulli | # Tekst (deri në 6 pads) |
Negrita | Tekst (gjithashtu dy nënvizime) |
italics | _Text_ (gjithashtu një yll) |
~~Tekst~~ | |
Të theksuara | ==Tekst== |
Nënvizuar | Tekst |
potencia | ^ + numër |
Nënshkrimi | ~ Teksti |
|
'*', '-' ose '+' + Teksti |
|
Numri + '.' ose ')' + Teksti |
I parë I dytë E treta |
'*', '-' ose '+' + '[ ]' ose '[x]' + Teksti |
Lidhje | [Spirancë] (lidhja «titulli») |
Skulpturë |  |
Emërimi | > Teksti |
Código |
'Tekst'. ̀ ̀ ̀ Teksti ̀ ̀ ̀ për blloqe |
Linjat horizontale | '***', '-' ose '___' |
barazim | Vizatimi i tyre (shih më lart) |
Matematikë | $formula$, $$$formula$$$ për blloqet |
Karakteri i arratisjes | "\" përballë |