U Beddel DOC ilaa Markdown

U Beddel DOC ilaa Markdown xuquuqda leh fududahay

Xullo faylashaada

*Faylasha waa la tirtiray 24 saacadood ka dib

U beddel ilaa 1 GB faylal bilaash ah, dadka isticmaala Pro waxay u rogi karaan ilaa 100 GB faylal; Isdiiwaangeli hadda

Soo gelinta

Sida loo beddelo DOC ilaa Markdown

Tallaabada 1aad: Soo geli DOC faylasha adoo isticmaalaya badhanka kore ama jiid oo hoos u dhig.

Tallaabada 2: Guji badhanka 'Beddelaan' si aad u bilowdo beddelka.

Tallaabada 3: Soo dejiso faylasha aad bedeshay Markdown faylasha

DOC ilaa Markdown Isbedelka FAQ

Sideen u beddeli karaa DOC si aan u nadiifiyo Markdown?

Soo deji DOC iyo soo beddelaha wuxuu dhismaha u beddelaa Markdown: tixraacyada waxay noqdaan `#` heerar, xoog badan / italic waxay noqdaan `**` / `*`, liiska waxay noqdaan `-` / `1.`, iyo xiriirada waxay noqdaan `[text] (url)`. Natiijadu waa qoraal fudud oo la qaadi karo Markdown waxaad ku ridi kartaa README, post-site-static, wiki, ama editor kasta Markdown.

Ma tixraacyada iyo liiska ka DOC ii madal Markdown?

Haa - heerarka tixraaca ee DOC waxay u beddelaan tirada isku midka ah ee xarfaha `#`, iyo liiska bullaacadaha / tirada / ku jira waxay u beddelaan `-` iyo `1.` calaamadaha leh indho-indheynta saxda ah. Markdown waxay ilaalisaa qaabka dukumintiga si dhismaha si deg deg ah loogu akhriyo qoraalka caadiga ah.

Sidee ayaa taabashada laga soo qaatay DOC loo muujiyaa Markdown?

Miisaska u beddelo GitHub-Flavored Markdown miisaska biyaha (`| col | col |` with a `---` separator row), kuwaas oo si sax ah u muujinaya GitHub, GitLab, iyo kuwa ugu badan ee soo saara goobta joogtada ah. Miisaska aad u ballaaran ama isku dhafan ee ka badan Markdown's simple grid ayaa la fududeeyay, tan iyo Markdown ma laha qaabka isku dhafan ee cell.

Maxaa ku dhaca sawirka marka la beddelo DOC ilaa Markdown?

Sawirada ku jira DOC waxaa laga soo saaraa faylka walaalka ah waxaana lagu soo bandhigaa '! [alt] (waddo)` qaabka Markdown, sidaa darteed Markdown waxay ku tusaysaa faylasha sawirka dhabta ah. Waxaad sidoo kale dooran kartaa inaad haysato URL-yada dhabta ah haddii sawirada horeyba loogu martiqaado khadka tooska ah.

Ma DOC ilaa Markdown ayaa ku daraya YAML hor-maada?

Haddii aad rabto - soo beddelaha wuxuu ku soo saari karaa blokada YAML ee horudhaca ah (`---` magaca / qoraha / taariikhda `---`) sare ee Markdown ka DOC metadata, taas oo si toos ah u ah waxa Jekyll, Hugo, iyo kuwa kale ee soo saara goobta joogtada ah ay rajaynayaan. Ka saar jirka nadiif ah oo keliya Markdown.

Markdown ma isticmaali doontaa ATX (`#`) ama Setext tixraacyada?

Markdown waxay u isticmaalaan ATX-style `#` tixraacyada default - heshiiska casriga ah ee si ballaaran loo taageeray oo ka shaqeeya nooc kasta oo Markdown ah oo u kala saara lixda heer ee tixraaca. Setext (la soo saaray) tixraacyada waxay u oggolaaneysaa laba heer oo keliya, sidaas darteed ATX waa doorasho ammaan ah oo badan.

Ma DOC ilaa Markdown ma ilaalin karaan xiriirada iyo xusuusta?

Hyperlinks noqdaan inline `[text] (url) `xariiqyo iyo, halkaas oo DOC calaamadaha footnotes dhab ah, waxay u beddelaan `[^1]` footnotes tixraacaya qaabka oo si sax ah u soo bandhigaan platforms taageeray kordhinta.

Ma ku beddeli karaa DOC ilaa Markdown si aan u helo GitHub README ama wiki?

Haa - natiijada waa GitHub-Flavored Markdown, sidaas darteed si sax ah ayuu u muujiyaa sida README, bogga wiki, su'aal, ama qeexida PR ee GitHub iyo GitLab. Miiska biraha, liiska hawlaha, blokada koodhka la xiray, iyo `#` tixraacyada dhammaantood waxay muujinayaan sida loo qorsheeyay markaad ku dhejiso ama ku dhaqaaqdo Markdown.

Ma DOC ayaa gaar ah marka la beddelayo?

Haa - faylasha la soo dejiyey DOC waxaa lagu dhaqaajiyaa shaqaalaha kala duwan oo la tirtiro daqiiqado gudahood. Waxaanan marnaba akhrin, kaydin, ama qaybin waxyaabaha. Eeg /privacy/.

Maxaa ka dhigaya Markdown ii leh astaamo HTML oo la isku daray?

Markdown ma awoodo inuu muujiyo astaamaha kasta oo xuquuqda leh (maqaal midab leh, miisaska adag, sanduuqa qoraalka), sidaa darteed soo saaraha ayaa dib ugu noqonaya HTML-ka HTML-ka ah ee qaybahaas ka badan inay ka soo baxaan - Markdown wuxuu u oggolaanayaa HTML-ka ku jira. Haddii aad rabto Markdown nadiif ah, fududeeyo qaabeynta DOC koowaad, ama u oggolaan "strip HTML fallback" ikhtiyaarka.

Ma DOC ilaa Markdown ma maamulaan blokada koodka?

Haa - monospaced / qoraalka hore ee qaabka ah ee DOC wuxuu noqdaa "`code block``` oo ku yaal Markdown, oo ilaaliya meel cad iyo, halkaas oo la ogaan karo, tilmaamaha afka ee loo yaqaan'syntax highlighting'. Tani waa muhiim marka la beddelo dukumintiga farsamada iyo waxbarashada Markdown.

Ma ku beddeli karaa DOC ilaa Markdown si loo abuuro goobta joogtada ah sida Hugo ama Jekyll?

Haa - u oggolaan YAML hor-maada iyo Markdown ka soo baxaya diyaar u ah in ay hoos u dhacaan `content /` ama `_posts /` folder: magaca iyo taariikhda in front-maada, jirka sida Markdown nadiif ah, sawirro in folder walaal.