Salungguhit sa Markdown: Gumagana sa GitHub at Ibang Renderer

Walang katutubong sintaks ang Markdown para sa pagsasalungguhit ng teksto. Sa CommonMark at GitHub Flavored Markdown, ang _teksto_ ay pahilis at ang __teksto__ ay makapal. Karaniwang kailangan ng suporta sa HTML o extension na partikular sa application para sa salungguhit.

Sa GitHub, ito ang dokumentadong anyo:

Biyernes ang <ins>binagong takdang petsa</ins>.

Inililista ng GitHub ang <ins>...</ins> para sa tekstong may salungguhit sa dokumentasyon nito sa pangunahing pag-format. Isa itong opsyon ng HTML na suportado ng platform, hindi bagong Markdown delimiter na gumagana sa lahat ng lugar.

Paghahambing ng salungguhit, makapal, at pahilis

Source	Kahulugan	Inaasahang suporta
_mahalaga_	Diin, karaniwang pahilis	CommonMark at GFM
__mahalaga__	Malakas na diin, karaniwang makapal	CommonMark at GFM
**mahalaga**	Malakas na diin, karaniwang makapal	CommonMark at GFM
<ins>idinagdag na teksto</ins>	Isiningit na teksto, karaniwang may salungguhit	Mga renderer na may HTML; dokumentado ng GitHub
<u>tekstong may anotasyon</u>	Anotasyon sa HTML, karaniwang may salungguhit	Mga renderer na pumapayag sa HTML element na ito

Piliin ang makapal o pahilis kung pagbibigay-diin ang layunin. Halimbawa, kapaki-pakinabang pa rin ang **Takda sa Biyernes** sa README, tala, at Markdown export nang hindi umaasa sa raw HTML.

Ano ang pagkakaiba ng ins at u?

Maaaring magkahawig ang dalawang tag, ngunit magkaiba ang kanilang kahulugan.

Kinakatawan ng <ins> ang tekstong isiningit sa dokumento. Angkop ito sa rebisyon gaya ng bagong idinagdag na pangangailangan. Karaniwan itong sinasalungguhitan ng browser, ngunit maaaring baguhin ng stylesheet ang anyong iyon. Tingnan ang sanggunian ng MDN sa isiningit na teksto.

Sinusuportahan ng bersiyon ang <ins>pag-import ng CSV at TSV</ins>.

Minamarkahan ng <u> ang anotasyong hindi karaniwang diin, gaya ng pagtukoy ng maling baybay. Hindi ito itinatakda ng modernong HTML bilang pangkalahatang tag na “gawing mahalaga ito”. Tingnan ang sanggunian ng MDN sa u element.

Pakisuri ang baybay ng <u>kumosta</u>.

Kung kontrolado mo ang website at kailangan ng salungguhit na biswal lamang, gamitin ang text-decoration: underline sa CSS. Maaaring alisin ng naka-host na Markdown platform ang mga style attribute o hindi payagan ang pasadyang estilo, kaya hindi rin portable ang paraang ito.

Bakit gumagana ang salungguhit sa isang editor ngunit nawawala sa iba?

May tatlong magkahiwalay na desisyon: kinikilala ng Markdown parser ang HTML, pinipili ng application kung aling tag ang pinapayagan nito, at itinatakda ng stylesheet ng destinasyon ang anyo ng pinapayagang mga element. Hindi garantiya ang suporta sa GFM na pinapayagan ng produkto ang lahat ng HTML tag.

Kasalukuyang inaalis ng MD File Viewer editor ang raw HTML tag sa input ng gumagamit. Kapag idinikit doon ang <ins>idinagdag na teksto</ins> o <u>tekstong may anotasyon</u>, naiiwan ang mga salita nang wala ang mga tag, kaya hindi sila sasalungguhitan sa paunang tingin. Gamitin ang paunang tinging iyon para sa suportadong Markdown formatting, at tiyakin ang pag-format na nakabatay sa HTML sa destinasyong paglalathalaan.

Kung inililipat mo ang HTML document sa Markdown, tumutulong ang HTML tungo sa Markdown converter na mabawi ang teksto, mga pamagat, link, at listahan. Maaaring mawala ang salungguhit at pasadyang CSS dahil walang katumbas na sintaks sa payak na Markdown. Suriin ang resulta bago palitan ang orihinal na dokumento.

Mga halimbawa ng GitHub README

Para sa maikling dagdag sa tala ng pagbabago, ito ang dokumentadong opsyon ng HTML sa GitHub:

Nagdaragdag ang bersiyong ito ng <ins>opsyonal na hakbang sa pag-import</ins>.

Para sa takdang petsa o pangangailangan, gumamit ng diin sa Markdown:

**Kailangan:** Magsama ng hanay ng pamagat sa CSV file.

Para sa destinasyon, gumamit ng link:

[Basahin ang mga tagubilin sa pag-import](https://example.com/import)

Maaaring magmukhang naki-click na link ang tekstong may salungguhit. Iwasang gawing mukhang interaktibo ang karaniwang mga label, lalo na kung may tunay na mga link sa parehong talata. Saklaw ng gabay sa mga link sa Markdown ang mapaglarawang teksto ng link at mga reference link.

Mga karaniwang pagkakamali sa salungguhit

Nagpapakapal ng teksto ang dobleng underscore. Binabago ng pagpapalit ng **salita** sa __salita__ ang delimiter, hindi ang kahulugan. Pareho silang kumakatawan sa malakas na diin.

Ipinapakita ng mga backtick ang tag bilang code. Kapaki-pakinabang sa tutorial ang pagsulat ng `<ins>teksto</ins>`, ngunit sadya nitong ipinapakita ang markup sa halip na i-render ito.

Sa application kabilang ang mga keyboard shortcut. Maaaring mag-alok ng utos ng salungguhit ang rich text editor at mag-imbak ng HTML o sariling format ng dokumento. Hindi nito ginagawang bahagi ng portable Markdown ang salungguhit.

Ibang konsepto ang pamagat na may guhit sa ilalim. Sa source na ito, lumilikha ang mga gitling ng pamagat na ikalawang antas:

Mga tala ng bersiyon
-------------

Hindi nila sinasalungguhitan ang parirala sa loob ng talata. Para sa panghiwalay sa pagitan ng mga seksiyon, gumamit ng pahalang na linya sa Markdown na may bakanteng linya sa paligid nito.

Mga madalas itanong

Paano ako magsasalungguhit sa Markdown sa GitHub?

Gamitin ang <ins>teksto</ins>, na idinodokumento ng GitHub para sa salungguhit. Para sa diing gumagana rin sa mga renderer na walang suporta sa HTML, gamitin ang **teksto** o *teksto*.

May alternatibo bang salungguhit na Markdown lamang ang gamit?

Walang pamantayang delimiter para sa salungguhit. Nagdaragdag ang ilang application ng sarili nilang sintaks, ngunit dapat mong suriin ang dokumentasyon nila at ang format na ginagamit sa pag-export.

Mananatili ba ang salungguhit sa conversion ng Markdown tungo sa PDF o Word?

Kung pinananatili lamang ng converter ang kaugnay na HTML o extension at sinusuportahan ang estilo nito. Huwag ipagpalagay na mananatili sa ibang exporter ang salungguhit na nakikita sa paunang tingin ng isang application. Suriin ang nabuong file, o gumamit ng pamantayang makapal na diin kung mahalaga ang portability.

Nagbibigay ang maikling sanggunian sa Markdown ng maikling gabay sa pag-format na may nakalaang sintaks ng Markdown.