Maqaallo / Markdown

Markdown: aasaaska, isticmaalka iyo talooyinka

Markdown waa luqad calaamadayn fudud oo loogu talagalay inay sahlan tahay akhrinteeda iyo qoristeeda. Waxay qoraal caadi ah oo fudud u beddeshaa dukumentiyo si qurux badan loo qaabeeyey iyada oo aan fikirkaaga kala goyn.

Waa maxay Markdown?

Markdown waa luqad calaamadayn fudud oo ay 2004 abuureen John Gruber iyo Aaron Swartz. Waxay kuu oggolaanaysaa inaad dukumentiyada qaabeyso adigoo adeegsanaya calaamadaha kiiboodhka ee fudud sida (#) iyo (-), adigoon gacmaha ka qaadin furayaasha.

Si ka duwan barnaamijyada waaweyn ee qoraalka ee leh qalabyo adag, Markdown wuxuu qoraalka asalka ah ka dhigaa mid dabiici ah oo la akhrin karo. Waxaad si buuxda diiradda u saari kartaa socodka fikradahaaga, halka abka casriga ahi isla markiiba uga dhigaan dukumentiyo nadiif ah oo habaysan.

Fudud in la akhriyo lana qoro

Waxaa loo naqshadeeyay inuu u ekaado qoraal caadi ah oo dabiici ah oo la akhrin karo, xitaa ka hor inta aan loo beddelin HTML qaabaysan.

Waara oo mustaqbalka u diyaarsan

Maaddaama lagu kaydiyo qoraal caadi ah oo meel kasta laga isticmaali karo, qoraalladaadu weligood kuma xirnaan doonaan qaab gaar loo leeyahay ama la joojiyey.

Fudud oo aan mashquulin

Ma jiraan daaqado adag ama dib-u-dhac qaabayneed—kaliya qoraal degdeg ah oo aan kala go' lahayn qalab kasta.

Horudhaca Markdown Tijaabi tusaalahan

Dulmar kooban oo hab-qoraalka aasaasiga ah

Waxaad u baahan tahay oo keliya dhowr xeer oo aasaasi ah si aad u qorto ku dhowaad dukumenti kasta. Hababkan fudud waxay kuu sahlaan inaad qoraalladaada isla markiiba qaabaysayso.

Cinwaannada (#)

Isticmaal hal ilaa lix calaamadood oo hash ah bilowga sadar si aad u dejiso kala-sarraynta dukumeentiga (# H1, ## H2, ### H3).

Liisaska (- iyo 1.)

Samee liisaska dhibcaha leh adigoo adeegsanaya jiitimo ama xiddigo, iyo liisaska tirooyinka leh tiro ay raacdo dhibic.

Xoojinta (**far waaweyn** iyo *far jiif ah*)

Ku wareeji qoraalka laba xiddigood si uu u noqdo dhumuc ama hal xiddig si uu u noqdo jiif, si aad u muujiso erayada muhiimka ah.

Xiriiriyeyaasha iyo sawirrada

Ku dar xiriiriyeyaal la gujin karo adigoo isticmaalaya [Label](URL), kuna dhex dar sawirro adigoo isticmaalaya ![Alt text](Image URL) si fudud.

Xigashooyin iyo qaybo kood ah

Ku bilow sadarrada > si aad u samayso xigashooyin qaybo ah, koodka ama qaacidooyinkana ku wareeji calaamadaha backtick.

Jadwallo iyo liisaska hubinta

Ku qaabee xogta jadwalka xariijimo taagan (|), kuna maamul liisaska hawlaha isdhexgalka - [x] iyo - [ ].

Xaggee Markdown ugu faa'iido badan yahay?

Markdown oo markii hore ay jeclaayeen horumariyeyaasha iyo qorayaashu, wuxuu noqday halbeeg guud oo dukumentiyada loo adeegsado meelo badan oo nolol maalmeedka iyo shaqada ah.

Qoraallada maalinlaha ah iyo ururinta fikradaha

Qor fikradaha degdegga u baaba'a, diiwaannada maalinlaha ah iyo liisaska hawlaha adigoon ku mashquulin qaabeynta.

Qoraallada iyo ajandayaasha kulanka

La soco doodaha tooska ah isla markiiba, adigoo qabanqaabinaya hawlaha iyo go'aannada inta ay socdaan.

Dukumentiyada iyo saldhigyada aqoonta

Qor faylasha README ee softiweerka, wiki-yada kooxda iyo buug-gacmeedyada ganacsiga oo meel kasta laga akhrisan karo.

Qorista baloogga iyo daabacaadda

Qor nuxur si nadiif ah loogu daabici karo nidaamyada casriga ah ee maareynta nuxurka, baloogyada teknoolojiyadda iyo bogagga joogtada ah.

Doorashada qalabka ku habboon habsocodka shaqadaada

Maadaama Markdown uu yahay halbeeg furan, waxaa jira barnaamijyo badan oo ku habboon habab shaqo oo kala duwan. Doorashada qalabka saxda ahi waxay ku xiran tahay mudnaantaada.

Shabakadaha aqoonta shakhsiyeed

Barnaamijyada sida Obsidian iyo Logseq waxay ururro waaweyn oo qoraallo ah ku xiraan xiriirro laba-geesood ah, iyagoo faylasha ku haya kombiyuutarkaaga.

Goobaha shaqo-wadaagga kooxda

Goobaha sida Notion iyo Scrapbox waxay isku daraan tafatirka Markdown, kaydad xogeed toos ah, goobo mashruuc oo wadaag ah iyo wiki-yo kooxeed.

Tifaftirayaasha koodka iyo daabacaadda

Qalabka sida VS Code iyo Typora waxay qoraayaasha farsamada siiyaan kordhinno awood leh, xakamaynta noocyada Git, iyo horudhacyo toos ah oo dhinac-dhinac ah.

Qoraallo fudud oo degdeg ah

Tifaftirayaal degdeg ah oo aan mashquul lahayn, oo loogu talagalay furitaan degdeg ah, qoraallo taleefanka lagu qoro iyo hubinta horudhaca iyada oo aan la samayn dejin adag.

Hab fudud oo lagu bilaabo moobilka iyo webka

Inkasta oo aaladaha aqoonta ee sifooyinka badan leh ay awood badan yihiin, haddana mararka qaarkood way cuslaan karaan ama waxay u baahan karaan barashada dejimo adag si aad qoraal kooban u qorto markaad socoto.

Haddii aad rabto hab fudud oo toos ah oo aad Markdown ugu qorto taleefankaaga ama biraawsarka, waxaan sidoo kale bixinnaa qalabkayaga bilaashka ah, Simple Markdown Editor. Uma baahna diiwaangelin isticmaale, wuxuuna kuu oggolaanayaa inaad si fudud ugu kala wareegto qorista iyo horudhaca adigoo shaashadda jiidaya. Marka laga reebo barnaamijyada moobilka, nooca webka waxaa si toos ah looga heli karaa biraawsarkaaga markdown.tanaike.jp, taasoo kuu sahlaysa inaad Markdown tijaabiso mar kasta oo fikrad kugu soo dhacdo.

Bilow isla markiiba adigoon isdiiwaangelin

Fur abka oo isla markiiba bilow qorista—looma baahna abuurista akoon, furayaal sir ah ama dejinta isku-waafajinta daruurta.

Jiidh si aad u aragto horudhaca

Si dhakhso leh u hubi qoraalkaaga qaabaysan adigoo si dabiici ah far ugu rogaya inta u dhexeysa shaashadaha tafatirka iyo horudhaca.

Waxaa laga heli karaa moobilka iyo webka

Isticmaal abka moobilka ee asalka ah ee iOS/Android ama ka gal nooca webka markdown.tanaike.jp biraawsarka kombiyuutar kasta adigoon wax rakibin.

Si fudud u tijaabi Markdown

Isla markiiba ku tijaabi qorista qoraallada Markdown iyo horudhacooda moobilka iyo webka, adigoon u baahnayn diiwaangelinta akoon.