Inkuru / Markdown

Markdown: iby'ibanze, imikoreshereze n'inama

Markdown ni ururimi rworoheje rwo gushyira imiterere mu nyandiko, rwakozwe ngo rworohe gusoma no kwandika. Ruhindura inyandiko isanzwe inyandiko ziteguye neza kandi zisa neza, rutabangamiye uko utekereza.

Markdown ni iki?

Markdown ni ururimi rworoheje rwo gushyira ibimenyetso ku nyandiko rwakozwe mu 2004 na John Gruber na Aaron Swartz. Rugufasha gutunganya inyandiko ukoresheje ibimenyetso byoroshye bya mwandikisho nka hash (#) na hyphen (-), udakuye amaboko ku mfunguzo.

Bitandukanye na porogaramu ziremereye zo gutunganya inyandiko zifite utubari tw’ibikoresho tugoye, Markdown ituma inyandiko y’umwimerere iguma isanzwe kandi yoroshye gusoma. Ushobora kwibanda ku buryo ibitekerezo byawe bikurikirana, mu gihe porogaramu zigezweho zihita zibihindura inyandiko zisukuye kandi zubatse neza.

Byoroshye gusoma no kwandika

Byakozwe kugira ngo inyandiko isanzwe igaragare neza kandi isomeke, na mbere yo kuyihindura HTML iteguye.

Biramba kandi byiteguye ejo hazaza

Kubera ko zibikwa nk'inyandiko isanzwe ikoreshwa hose, inyandiko zawe ntizizigera zifungiranwa mu bwoko bwa dosiye bwihariye cyangwa bwahagaritswe.

Yoroheje kandi itarangaza

Nta dusanduku tw'ibiganiro tugoye cyangwa gutinda mu gutunganya imiterere—andika vuba kandi udahagarara ku gikoresho icyo ari cyo cyose.

Igaragazambere rya Markdown Gerageza uru rugero

Imiterere y'ibanze y'inyandiko muri make

Ukeneye amategeko make y'ibanze gusa kugira ngo wandike hafi inyandiko iyo ari yo yose. Ubu buryo bworoshye butuma gutunganya ibyo wandika uri mu rugendo bitagorana.

Imitwe (#)

Koresha ibimenyetso bya hash kuva kuri kimwe kugeza kuri bitandatu mu ntangiriro y’umurongo kugira ngo werekane inzego z’inyandiko (# H1, ## H2, ### H3).

Intonde (- na 1.)

Kora urutonde rw’utudomo ukoresheje uturongo cyangwa inyenyeri, n’urutonde rubaruwe ukoresheje imibare ikurikiwe n’akadomo.

Gushimangira (**inyuguti zitsindagiye** na *ziberamye*)

Zengurutsa inyandiko inyenyeri ebyiri kugira ngo ibe inyuguti zitsindagiye cyangwa imwe kugira ngo ibe inyuguti ziberamye, ugaragaze amagambo y’ingenzi.

Amahuza n'amashusho

Ongeramo amahuza akandwaho ukoresheje [Label](URL), kandi ushyiremo amashusho ukoresheje ![Inyandiko isimbura ishusho](Image URL) mu buryo bworoshye.

Amagambo yasubiwemo n'ibice bya kode

Shyira > mu ntangiriro y'imirongo ku magambo yasubiwemo mu gice cyihariye, uzengurutse kode cyangwa amafomula utumenyetso twa backtick.

Imbonerahamwe n'urutonde rw'ibigenzurwa

Tunganya amakuru yo mu mbonerahamwe ukoresheje uturongo duhagaritse (|), kandi ucunge urutonde rw'imirimo rukorana n'ukoresha ukoresheje - [x] na - [ ].

Ni hehe Markdown igira akamaro kurushaho?

Markdown yakundwaga mbere n'abakora porogaramu n'abanditsi, none yabaye uburyo rusange bwo gukora inyandiko mu nzego nyinshi z'ubuzima bwa buri munsi n'akazi.

Inyandiko za buri munsi no kungurana ibitekerezo

Andika ibitekerezo biza bigahita, ibyandikwa bya buri munsi n’urutonde rw’ibyo gukora utarangajwe n’imiterere y’inyandiko.

Inyandikomvugo n’ingingo z’inama

Kurikira ibiganiro biri kuba ako kanya, utunganye imirimo igomba gukorwa n'ibyemezo uko bigenda bifatwa.

Inyandiko zisobanura n'ububiko bw'ubumenyi

Andika dosiye za README za porogaramu, wiki z'amatsinda n'imfashanyigisho z'ubucuruzi zisomeka ahantu hose.

Kwandika kuri blog no gutangaza

Tegura ibikubiyemo bishobora gutangazwa neza muri sisitemu zigezweho zo gucunga ibikubiyemo, blog z’ikoranabuhanga n’imbuga zidahinduka.

Guhitamo igikoresho gikwiye ku mikorere yawe

Kubera ko Markdown ari igipimo gifunguye, hari porogaramu nyinshi zagenewe uburyo butandukanye bwo gukora. Guhitamo igikoresho gikwiye biterwa n'ibyo ushyira imbere.

Ibishushanyo by’ubumenyi bwite

Porogaramu nka Obsidian na Logseq zihuza amakusanyirizo manini y'inyandiko hifashishijwe amahuza ajya mu byerekezo byombi, mu gihe dosiye ziguma zibitswe kuri disiki yawe.

Ahakorerwa ubufatanye bw’itsinda

Imbuga nka Notion na Scrapbox zihuza guhindura Markdown n'ububiko bw'amakuru buvugururwa ako kanya, ahantu ho gukorera imishinga hasangiwe na wiki z'amatsinda.

Porogaramu zo guhindura kode no gutangaza

Ibikoresho nka VS Code na Typora biha abandika inyandiko za tekiniki inyongera zikomeye, igenzura ry’impinduka za Git n’ibigaragaza inyandiko ako kanya iruhande rw’aho yandikirwa.

Kwandika utuntu tw'ingenzi mu buryo bworoshye

Ibikoresho byo guhindura inyandiko byihuta kandi bidarangaza, byo gutangira ako kanya, kwandika inyandiko kuri telefoni no kureba uko bizagaragara nta igenamiterere rigoye.

Uburyo bworoshye bwo gutangira kuri telefoni no kuri interineti

Nubwo ibikoresho by'ubumenyi bifite imikorere myinshi bikomeye, rimwe na rimwe bishobora kugorana cyangwa bigasaba kwiga igenamiterere rikomeye kugira ngo wandike akantu gato uri mu rugendo.

Niba ushaka uburyo bworoshye kandi butagoye bwo kwandika Markdown kuri telefoni cyangwa muri mushakisha, dutanga n’igikoresho cyacu cy’ubuntu, Simple Markdown Editor. Ntigisaba kwiyandikisha kandi kigufasha guhinduranya mu buryo bworoshye hagati yo kwandika no kureba uko bizagaragara ukoresheje kunyuza urutoki. Uretse porogaramu za telefoni, verisiyo yo ku rubuga iboneka muri mushakisha kuri markdown.tanaike.jp, bityo ukaba wagerageza Markdown igihe cyose ugize igitekerezo.

Tangira ako kanya utiriwe wiyandikisha

Fungura porogaramu uhite utangira kwandika—nta gufungura konti, ijambo ry'ibanga cyangwa gutegura ihuzwa ry'amakuru mu gicu.

Nyereza kugira ngo ubone ibizagaragara

Genzura vuba inyandiko iteguye unyerera mu buryo busanzwe hagati y’ahandikirwa n’aherekanwa uko izagaragara.

Biboneka kuri telefoni no kuri interineti

Koresha porogaramu ya telefoni yabugenewe kuri iOS/Android cyangwa ugere kuri verisiyo y'urubuga kuri markdown.tanaike.jp ukoresheje mushakisha ya mudasobwa iyo ari yo yose utabanje kuyishyiramo.

Gerageza Markdown mu buryo bworoshye

Gerageza guhita wandika inyandiko za Markdown no kureba uko zigaragara kuri telefone no kuri interineti, utabanje kwiyandikisha.