Markdown është ndoshta mënyra më e mirë për të marrë shënime në një PC. Ne shpjegojmë se si ta përdorim atë

Markdown

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:

  1. Përgatitja:
    1. ISO është shkarkuar.
    2. Është regjistruar në një USB.
  2. instalimit:
    1. USB-ja futet në pajisje.
    2. 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:

![Linux Mint Wallpapers](https://www.linuxadictos.com/wp-content/uploads/Fondos-de-screenla-de-Victoria.png "E disponueshme në janar")

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.

[![Linux Mint Wallpapers](https://www.linuxadictos.com/wp-content/uploads/Fundos-de-screenla-de-Victoria.png "Kjo çon në DuckDuckGo")](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:

Kodi Python

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):

Veprimi matematikor në Markdown

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 JoplinApostrofi 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)
gërmave ~~Tekst~~
Të theksuara ==Tekst==
Nënvizuar Tekst
potencia ^ + numër
Nënshkrimi ~ Teksti
  • I parë
  • I dytë
  • E treta
'*', '-' ose '+' + Teksti
  1. I parë
  2. I dytë
  3. E treta
Numri + '.' ose ')' + Teksti
I parë
I dytë
E treta
'*', '-' ose '+' + '[ ]' ose '[x]' + Teksti
Lidhje [Spirancë] (lidhja «titulli»)
Skulpturë ![Tekst alt](lidhje)
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ë

Lini komentin tuaj

Adresa juaj e emailit nuk do të publikohet. Fusha e kërkuar janë shënuar me *

*

*

  1. Përgjegjës për të dhënat: AB Internet Networks 2008 SL
  2. Qëllimi i të dhënave: Kontrolloni SPAM, menaxhimin e komenteve.
  3. Legjitimimi: Pëlqimi juaj
  4. Komunikimi i të dhënave: Të dhënat nuk do t'u komunikohen palëve të treta përveç me detyrim ligjor.
  5. Ruajtja e të dhënave: Baza e të dhënave e organizuar nga Occentus Networks (BE)
  6. Të drejtat: Në çdo kohë mund të kufizoni, rikuperoni dhe fshini informacionin tuaj.