Izindatshana / Markdown

Markdown: okuyisisekelo, ukusetshenziswa namathiphu

I-Markdown ulimi olulula lokumaka olwakhelwe ukuba lufundeke futhi lubhaleke kalula. Luguqula umbhalo olula ube amadokhumenti afomethwe kahle ngaphandle kokuphazamisa ukugeleza kwemicabango yakho.

Yini i-Markdown?

I-Markdown iwulimi lokumaka olulula olwakhiwa ngo-2004 nguJohn Gruber noAaron Swartz. Ikuvumela ukufometha imibhalo usebenzisa izimpawu ezilula zekhibhodi ezinjengo-# no-(-), ngaphandle kokususa izandla okhiye.

Ngokungafani nezinhlelo ezinkulu zokucubungula amagama ezinamabha amathuluzi ayinkimbinkimbi, i-Markdown igcina umbhalo womthombo ungowemvelo futhi ufundeka kalula. Ungagxila ngokuphelele ekugelezeni kwemicabango yakho, kuyilapho izinhlelo zokusebenza zesimanje ziwubonisa njengemibhalo ehlanzekile nehlelekile ngesikhathi sangempela.

Kulula ukuyifunda nokuyibhala

Yakhelwe ukubukeka ngokwemvelo nokufundeka njengombhalo olula, ngisho nangaphambi kokuguqulelwa ku-HTML efomethiwe.

Ihlala isikhathi eside futhi ilungele ikusasa

Njengoba agcinwe njengombhalo ovamile osebenza kuyo yonke indawo, amanothi akho awasoze avaleleka kufomethi yobunikazi noma engasasetshenziswa.

Kulula futhi akunaziphazamiso

Azikho izingxoxo eziyinkimbinkimbi noma ukubambezeleka kokufometha—ukubhala ngokushesha ngaphandle kokuphazamiseka kunoma iyiphi idivayisi.

Ukubuka kuqala kwe-Markdown Zama lesi sibonelo

Imithetho eyisisekelo yokubhala ngamafuphi

Udinga imithetho embalwa nje eyisisekelo ukuze ubhale cishe noma yiluphi udokhumenti. Lezi zindlela ezilula zenza kube lula ukuhlela amanothi akho ngaso leso sikhathi.

Izihloko (#)

Sebenzisa uphawu olulodwa kuya kweziyisithupha ze-hash ekuqaleni komugqa ukuze wakhe izigaba zedokhumenti (# H1, ## H2, ### H3).

Uhlu (- no-1.)

Dala uhlu olunamachashazi usebenzisa amakhonco noma izinkanyezi, nohlu olunezinombolo usebenzisa izinombolo ezilandelwa yichashazi.

Ukugcizelela (**okugqamile** kanye *nokutshekile*)

Zungeza umbhalo ngezinkanyezi ezimbili ukuze ube ugqinsi noma ngenkanyezi eyodwa ukuze utsheke ukuze ugqamise amagama abalulekile.

Izixhumanisi nezithombe

Engeza izixhumanisi ezichofozekayo nge-[Label](URL) bese ufaka izithombe kalula nge-![Alt text](Image URL).

Izingcaphuno namabhulokhi ekhodi

Qala imigqa ngo > ukuze wenze izingcaphuno zebhulokhi, uzungeze ikhodi noma amafomula ngezimpawu ze-backtick.

Amathebula nohlu lokuhlola

Hlela idatha yethebula ngemigqa eqondile (|) futhi uphathe izinhlu zemisebenzi ezisebenzisanayo ngo- - [x] nango- - [ ].

I-Markdown isebenza kahle kuphi?

IMarkdown, eyayithandwa ekuqaleni ngabathuthukisi nababhali, isiphenduke indinganiso ejwayelekile yokubhala amadokhumenti emikhakheni eminingi yansuku zonke neyomsebenzi.

Amanothi ansuku zonke nokucobelelana ngemibono

Bhala imicabango edlulayo, amarekhodi ansuku zonke nohlu lwezinto okufanele zenziwe ngaphandle kokuphazanyiswa izitayela zokufometha.

Amaminithi nama-ajenda emihlangano

Landela izingxoxo ezibukhoma ngesikhathi sangempela, uhlele imisebenzi nezinqumo zisenzeka.

Imibhalo nezinqolobane zolwazi

Bhala amafayela e-README esofthiwe, ama-wiki eqembu nezincwadi zebhizinisi ezifundeka yonke indawo.

Ukubhala ibhulogi nokushicilela

Bhala okuqukethwe okushicileleka kahle ezinhlelweni zesimanje zokuphatha okuqukethwe, kumabhulogi ezobuchwepheshe nakumasayithi angashintshi.

Ukukhetha ithuluzi elifanele indlela yakho yokusebenza

Njengoba iMarkdown iyindinganiso evulekile, kunenqwaba yezinhlelo zokusebenza ezilungele izindlela zokusebenza ezahlukene. Ukukhetha ithuluzi elifanele kuncike ezintweni ozibeka phambili.

Amagrafu olwazi lomuntu siqu

Izinhlelo ezifana ne-Obsidian ne-Logseq zixhumanisa amaqoqo amakhulu amanothi ngezixhumanisi eziya nhlangothi zombili kuyilapho zigcina amafayela endaweni kudiski yakho.

Izindawo zokusebenzisana zeqembu

Amapulatifomu afana ne-Notion ne-Scrapbox ahlanganisa ukuhlela iMarkdown nezizindalwazi ezibuyekezwa ngesikhathi sangempela, izindawo zamaphrojekthi okwabelwana ngazo nama-wiki amaqembu.

Abahleli bekhodi nokushicilela

Amathuluzi afana ne-VS Code ne-Typora anikeza ababhali bezobuchwepheshe izandiso ezinamandla, ukulawula izinguqulo nge-Git nokubuka kuqala okubukhoma okuhambisanayo.

Ukubhala amanothi kalula

Abahleli abasheshayo abangenaziphazamiso, abagxile ekuqaliseni ngokushesha, ekubhaleni amanothi kumakhalekhukhwini nasekuhloleni ukubuka kuqala ngaphandle kokusetha okuyinkimbinkimbi.

Indlela elula yokuqala kuselula nakuwebhu

Nakuba amathuluzi olwazi anezici eziningi enamandla, ngezinye izikhathi angazwakala esinda noma adinge ukufunda izilungiselelo eziyinkimbinkimbi ukuze nje ubhale inothi elisheshayo usohambweni.

Uma ufuna indlela elula neqondile yokubhala iMarkdown ocingweni lwakho noma esipheqululini, siphinde sinikeze ithuluzi lethu lamahhala, Simple Markdown Editor. Alidingi ukubhalisa komsebenzisi futhi likuvumela ukuthi ushintshe kalula phakathi kokubhala nokubuka kuqala ngokuswayipha. Ngaphandle kwezinhlelo zokusebenza zeselula, inguqulo yewebhu itholakala ngqo esipheqululini sakho ku-markdown.tanaike.jp, okwenza kube lula ukuzama iMarkdown noma nini lapho uthola ugqozi.

Qala ngokushesha ngaphandle kokubhalisa

Vula uhlelo lokusebenza bese uqala ukubhala ngokushesha—akudingeki udale i-akhawunti, amaphasiwedi noma ulungise ukuvumelanisa kwefu.

Swayipha ukuze ubuke kuqala

Hlola ngokushesha umbhalo wakho ofomethiwe ngokuswayipha ngokwemvelo phakathi kwesikrini somhleli nesokubuka kuqala.

Iyatholakala kumakhalekhukhwini nakuwebhu

Sebenzisa uhlelo lokusebenza lweselula lwendabuko ku-iOS/Android noma finyelela inguqulo yewebhu ku-markdown.tanaike.jp ngesiphequluli sanoma iyiphi ikhompyutha ngaphandle kokufaka.

Zama i-Markdown kalula

Zama ukubhala amanothi e-Markdown nokuwabuka kuqala ngokushesha kumakhalekhukhwini nakuwebhu, ngaphandle kokubhalisa i-akhawunti.