Kramdown tez, sof Ruby Markdown-superset konvertori

Matn belgilash

Ushbu elementlarning barchasi span-darajali elementlardir va matn qismlarini belgilash uchun blok darajasidagi elementlar ichida ishlatiladi. Misol uchun, osongina havolalar yaratish yoki ma'lum matn qismlariga urg'u berish mumkin.


E'tibor bering, bo'sh span-darajali elementlar bo'sh HTML teglariga aylantirilmaydi, lekin chiqishda bo'lgani kabi ko'chiriladi.

Havolalar va rasmlar

Uch turdagi havolalar qo'llab-quvvatlanadi: avtomatik havolalar, ichki havolalar va mos yozuvlar havolalari.

Avtomatik havolalar

Buni yaratish eng oson: veb-manzil yoki elektron pochta manzilini burchakli qavslar bilan o'rab oling va manzil tegishli havolaga aylanadi. Manzil havola maqsadi va havola matni sifatida ishlatiladi. Masalan:

Information can be found on the homepage. You can also mail me:


Avtomatik havolalar yordamida boshqa havola matnini belgilash mumkin emas - buning uchun boshqa havola turlaridan foydalaning!

Inline havolalar

So'zdan ko'rinib turibdiki, inline havolalar matn oqimidagi barcha ma'lumotlarni taqdim etadi. Malumot uslubidagi havolalar faqat matn oqimidagi havola matnini ta'minlaydi va qolgan hamma narsa boshqa joyda aniqlanadi. Bu sizga havola ta'riflarini qayta ishlatishga ham imkon beradi.


Inline uslubidagi havola havola matnini kvadrat qavslar bilan o'rab, undan so'ng darhol havola URL manzilini (va ixtiyoriy sarlavhani oddiy qavslar ichida bitta yoki ikkita tirnoq ichida kamida bitta bo'sh joy qo'yish orqali) yaratish mumkin. Masalan:

This is [a link](http://rubyforge.org) to a page.
A [link](../test "local URI") can also have a title. And [spaces](link with spaces.html)!

Eslatmalar:

Havola matni oddiy intervalli matn kabi ko'rib chiqiladi va shuning uchun tahlil qilinadi va o'zgartiriladi. Biroq, agar siz havola matnida kvadrat qavslardan foydalansangiz, ularni to'g'ri joylashtirishingiz yoki ulardan qochishingiz kerak. Ichki havolalarni yaratish mumkin emas!

https://kramdown.gettalong.org/syntax.html 20/30
07.05.2023, 19:53 Sintaksis | Kramdown
Havola matni, masalan, havola langarlarini yaratish uchun ham o'tkazib yuborilishi mumkin.

Agar sarlavha ko'rsatilmagan bo'lsa, havola URL manzilida to'g'ri joylashtirilgan qavslar bo'lishi kerak yoki havola URL manzili burchakli qavslar ichida bo'lishi kerak (noto'g'ri kiritilgan qavslarga ruxsat beriladi).


Havola sarlavhasida chegaralovchilar boʻlmasligi va boʻsh boʻlmasligi mumkin.

Qo'shimcha havola atributlarini ichki havoladan keyin IAL oralig'idan foydalanib qo'shish mumkin , masalan:

This is a [link](http://example.com){:hreflang="de"}

Malumot havolalari

Malumot uslubi havolasini yaratish uchun siz havola matnini kvadrat qavslar bilan o'rashingiz kerak (ichidagi havolalar kabi), keyin ixtiyoriy bo'shliqlar/yorliqlar/satr tanaffuslari va ixtiyoriy ravishda ulardagi havola identifikatori bilan boshqa kvadrat qavslar to'plami bilan keyin. Bog'lanish identifikatorida yopish qavs va havola ta'rifida ko'rsatilgan bo'lsa, yangi qator belgilari bo'lmasligi mumkin; u ham katta-kichik harflarga sezgir emas, qatorlar va yorliqlar bo'shliqlarga aylantiriladi va bir nechta bo'shliqlar bittaga siqiladi. Masalan:

This is a [reference style link][linkid] to a page. And [this] [linkid] is also a link. As is [this][] and [THIS].

Agar siz havola identifikatorini ko'rsatmasangiz (ya'ni, faqat bo'sh kvadrat qavslardan foydalaning) yoki kvadrat qavslarning ikkinchi juftligini butunlay tashlab qo'ysangiz, havola matni barcha noto'g'ri belgilarni olib tashlash va qatorlar uchun bo'sh joy qo'yish orqali haqiqiy havola identifikatoriga aylantiriladi. Agar havola identifikatori uchun havola ta'rifi topilsa, havola yaratiladi. Aks holda matn havolaga aylantirilmaydi.


Inline havolalarda bo'lgani kabi, qo'shimcha havola atributlari havoladan keyin IAL oralig'idan foydalanib qo'shilishi mumkin .

Bog'lanish ta'riflari

Havola ta'rifi hujjatning istalgan joyiga joylashtirilishi mumkin. Chiqishda ko'rinmaydi. Havola ta'rifi quyidagicha ko'rinadi:

[linkid]: http://www.example.com/ "Optional Title"

Bog'lanish ta'riflari, bu erda tavsiflanganiga qaramay, kontent bo'lmagan blok darajasidagi elementlardir.


Bog'lanish ta'rifi quyidagi tuzilishga ega:

Kvadrat qavs ichidagi havola identifikatori, ixtiyoriy ravishda uchta bo'sh joygacha chekinish, keyin ikki nuqta va bir yoki bir nechta ixtiyoriy bo'shliqlar/yorliqlar,
keyin kamida bitta bo'sh joy bo'lmagan belgi yoki chap burchakli qavs, havola URL manzili va o'ng burchakli qavsni o'z ichiga olishi kerak bo'lgan havola URL manzili,
keyin ixtiyoriy ravishda bitta yoki qoʻsh tirnoq ichidagi sarlavha havolaning URL manzilidan bir yoki bir nechta boʻsh joy bilan ajratilgan yoki keyingi qatorda istalgan miqdordagi boʻshliqlar/yorliqlar oʻz-oʻzidan chizilgan.

Asl Markdown sintaksisi sarlavhani qavs ichida ko'rsatishga ham imkon berdi. Satr sarlavhasiga mos kelishi uchun bunga ruxsat berilmaydi.


Agar sizda havola taʼrifiga oʻxshagan, lekin haqiqatda havola va baʼzi matn boʻlishi kerak boʻlgan matn boʻlsa, havola identifikatoridan keyin yoʻgʻon nuqta qoʻyishingiz mumkin:

https://kramdown.gettalong.org/syntax.html 21/30
07.05.2023, 19:53 Sintaksis | Kramdown
The next paragraph contains a link and some text.

[Room 100]\: There you should find everything you need!

[Room 100]: link_to_room_100.html

Havola ta'riflari kontent bo'lmagan blok darajasidagi elementlar bo'lsa-da, ularda havolalar uchun qo'shimcha atributlarni belgilash uchun blok IAL'lardan foydalanish mumkin:

[linkid]: http://example.com {:hreflang="de"}