Kramdown tez, sof Ruby Markdown-superset konvertori

07.05.2023, 19:53 Sintaksis | Kramdown

Kramdown

tez, sof Ruby Markdown-superset konvertori

Uy O'rnatish Hujjatlar
Tezkor havola Sintaksis

Tarkib

Kramdown sintaksisi
Manba matnini formatlash Chiziqlarni o'rash Tablardan foydalanish
Avtomatik va qo'lda qochish Blok chegaralari
Strukturaviy elementlar Bo'sh chiziqlar Paragraflar Sarlavhalar
Matn uslubi atx uslubi
Sarlavha identifikatorini belgilash Blok tirnoq
Kod bloklari
Standart kod bloklari Devorlangan kod bloklari Kod bloklari tili
Ro'yxatlar
Tartibli va tartibsiz ro'yxatlar Ta'riflar ro'yxati
Jadvallar Gorizontal qoidalar Matematik bloklar HTML bloklari
Matn belgilash
Havolalar va rasmlar Avtomatik havolalar Inline havolalar Malumot havolalari Bog'lanish ta'riflari Tasvirlar
Ta'kidlash Kod oralig'i
HTML oraliqlari Izohlar Qisqartmalar Tipografik belgilar
Tarkib bo'lmagan elementlar Blokni tugatish belgisi Atributlar roʻyxati taʼriflari Inline atributlar roʻyxati

https://kramdown.gettalong.org/syntax.html 1/30

07.05.2023, 19:53 Sintaksis | Kramdown
Inline atributlar roʻyxatini bloklash Inline atributlar roʻyxatini kengaytiring
Kengaytmalar

Kramdownni qo'llab-quvvatlash

Agar sizga kramdown yoqsa va uni qo‘llab-quvvatlamoqchi bo‘lsangiz, kichik xayriya qilishingiz mumkin (Patreon yoki PayPal) -- bu albatta qadrlanadi! Rahmat!


Homiyga aylaning!

Homiylar

GROSSWEBER dasturiy ta'minotni ishlab chiqish bo'yicha maslahat va ta'lim xizmatlarini taqdim etadi . Biz ochiq manbada ishlashni yaxshi ko'ramiz. Biz undan qattiq foydalanamiz. Biz krampunni yaxshi ko'ramiz!

Kramdown sintaksisi

Bu sintaksis hujjatlarining 2.4.0 versiyasidir .

Kramdown sintaksisi Markdown sintaksisiga asoslangan va Maruku , PHP Markdown Extra va Pandoc kabi boshqa Markdown ilovalarida topilgan xususiyatlar bilan yaxshilangan . Biroq, u qat'iy sintaksisni aniq qoidalar bilan ta'minlashga intiladi va shuning uchun Markdown bilan to'liq mos kelmaydi. Shunga qaramay, Markdown hujjatlarining aksariyati kramdown bilan tahlil qilinganda yaxshi ishlashi kerak. Kramdown sintaksisi Markdown sintaksisidan farq qiladigan barcha joylar ajratilgan.


Quyida kramdown qo'llab-quvvatlaydigan barcha elementlar uchun to'liq sintaksis ta'rifi keltirilgan. Mavjud konvertorlar bo'yicha hujjatlar bilan birgalikda, kramdown hujjati o'zgartirilganda nima olishingiz aniq ko'rsatilgan.

Manba matnini formatlash

Kramdown hujjati har qanday kodlashda bo'lishi mumkin, masalan, ASCII, UTF-8 yoki ISO-8859-1 va chiqish manba bilan bir xil kodlashga ega bo'ladi.


Hujjat ikki turdagi elementlardan, blok-darajali elementlardan va span-darajali elementlardan iborat:

Blok darajasidagi elementlar kontentning asosiy tuzilishini belgilaydi, masalan, matnning qaysi qismi paragraf, ro'yxat, blok-iqtibos va hokazo bo'lishi kerak.


Span-darajali elementlar kichik matn qismlarini, masalan, ta'kidlangan matn yoki havola sifatida belgilaydi.


Shunday qilib, oraliq darajasidagi elementlar faqat blok darajasidagi elementlar yoki boshqa oraliq darajali elementlar ichida paydo bo'lishi mumkin.


Blok darajasidagi element tavsiflarida ko'pincha satrning "birinchi ustuni" yoki "birinchi belgisi" ga havolalarni topasiz. Bunday havola har doim joriy chekinish darajasiga nisbatan olinishi kerak, chunki ba'zi blok darajasidagi elementlar yangi chekinish darajasini ochadi (masalan, blok tirnoqlari). Kramdown hujjatining boshlanishi matnning birinchi ustunidan boshlanadigan standart chekinish darajasini ochadi.

Chiziqlarni o'rash

https://kramdown.gettalong.org/syntax.html 2/30
07.05.2023, 19:53 Sintaksis | Kramdown
Ba'zi engil belgilash sintaksisi chiziqlar qattiq o'ralgan muhitda yaxshi ishlamaydi. Misol uchun, bu ko'plab elektron pochta dasturlarida sodir bo'ladi. Shuning uchun, kramdown paragraflar yoki blok qo'shtirnoqlar kabi kontentni qattiq o'rashga, ya'ni satrlar bo'ylab kesishga imkon beradi. Bu ba'zan "dangasa sintaksis" deb ataladi, chunki tarkibning birinchi qatori uchun zarur bo'lgan chiziq yoki satr prefiksi ketma-ket qatorlar uchun talab qilinmaydi.


Chiziqlarni o'rashni qo'llab-quvvatlaydigan blok darajasidagi elementlar har doim quyidagi shartlardan biri bajarilganda tugaydi:


bo'sh satr , EOB belgisi chizig'i , IAL bloki yoki hujjatning oxiri (ya'ni blok chegarasi ),

yoki HTML bloki .

Kramdown hujjatida qatorni oʻrashga ruxsat beriladi, lekin qattiq oʻrashni qoʻllab-quvvatlamaydigan blok -darajali elementlar mavjud:


sarlavhalar

Ko'pgina hollarda bu muammo emas, chunki sarlavhalar odatda bitta satrga to'g'ri keladi. Agar sarlavha matni bitta satr uchun juda uzun bo'lsa, uning o'rniga HTML sintaksisidan foydalanishingiz kerak.


o'ralgan kod bloklari

O'ralgan kod blokining chegaralovchi chiziqlari qattiq o'rashni qo'llab-quvvatlamaydi. Chegaruvchi chiziqlar orasidagi hamma narsa avvalgidek olinganligi sababli, o'ralgan kod blokining mazmuni qattiq o'rashni ham qo'llab-quvvatlamaydi.


ta'riflar ro'yxati atamalari

Har bir ta'rif atamasi alohida satrda ko'rsatilishi kerak. Shuning uchun qattiq o'rash qo'shimcha ta'rif atamalarini kiritadi. Biroq, ta'riflarning o'zi qattiq o'rashni qo'llab-quvvatlaydi.

jadvallar

Kramdown jadvalining har bir satri bitta jadval qatori yoki ajratgichni tavsiflaganligi sababli, jadvallarni qattiq o'rash mumkin emas.