MD пішімі (Markdown)
MD — торкөз белгісі тақырыпты, жұлдызшалар ерекшелеуді, сызықша тізім тармағын білдіретін кәдімгі мәтіндік файл. Ішінде парақ өлшемі, қаріп пен жиек туралы дерек жоқ, сондықтан құжаттың түрі де жоқ: оны белгіленімді көрсететін бағдарлама ойлап табады. Басып шығару әрқашан екі қадаммен жүреді — әуелі белгіленім HTML-ге айналады, содан кейін HTML-ді браузер қозғалтқышы басады. Сондықтан бір файл әр бағдарламада әртүрлі PDF береді.
Сандар туралы қысқаша
- Бұл қандай файл
- қарапайым мәтін, әдетте UTF-8 кодтауында
- Ерекшелік
- CommonMark; GitHub диалектісі кесте мен тапсырма тізімін қосады
- Пішімде жоқ нәрсе
- парақ өлшемі, жиек, қаріп және бет үзілісі
- Басуға дейінгі жол
- белгіленім → HTML → браузер қозғалтқышымен басу
- Біздің маршруттар
- .md қабылдамайды, .html немесе .htm керек
Белгіленім мен құжат пішімі — бөлек нәрсе
Markdown мағынаны айтады: мынау екінші деңгейлі тақырып, мынау дәйексөз, мынау код блогы. Ол «қаріп 18 пункт, үстінен 12 пункт бос орын» демейді. Мұның бәрін көрсететін бағдарлама өз стильдерімен қосады, ал стильдер бағдарламадан бағдарламаға, тақырыптан тақырыпқа, нұсқадан нұсқаға өзгереді.
Мұндай құрылымның күшті жағы бар: файл ешқандай қосымшасыз көзбен оқылады, нұсқаларды бақылау жүйесіне жақсы жатады және операциялық жүйелер арасында тасымалдағанда бұзылмайды. Әлсіз жағы да бар: белгіленім нақты стильдері бар HTML-ге айналмайынша, сіз бет бөлінісін де, жиекті де, кестенің қай жерде үзілетінін де басқармайсыз.
Файлдың түрін өзгертетін диалектілер
- Негізгі ережелерді CommonMark ерекшелігі бекітеді — ол бастапқы сипаттамадағы қосарлықты жояды.
- GitHub диалектісі кестелерді, сызып тастауды, тапсырма тізімдерін және автоматты сілтемелерді қосады.
- Ескертпелер, файл басындағы метадерек блогы және математикалық формулалар — негізгі жиынтықта жоқ кеңейтулер.
- Осыдан таныс жағдай шығады: бір диалектінің ережесімен терілген кесте қатаң көрсетуде тік сызықтары бар жолдар күйінде қалады.
- Кірістірілген тізімдер бос орын санына сезімтал: екі және төрт бос орынды әр көрсеткіш әрқалай түсінеді.
Басып шығарғанда не болады
- Бағдарлама белгіленімді HTML-ге аударады: торкөз тақырып тегіне, жұлдызшалар ерекшелеу тегіне айналады.
- Осы HTML-ге оның өз стильдері қолданылады — қаріп, кегль, баған ені, жиектер.
- Браузер қозғалтқышы шыққан бетті басып, биіктігі бітетін жерден парақтарға кеседі.
- Үзіліс қай жерге түссе, сонда түседі: ұзын код блогы мен кең кесте ортасынан жыртылады.
- Бағдарламаны ауыстырсаңыз, сол файлдан басқа стиль мен басқа бет саны шығады.
PDF-ке дейінгі болжамды жол
- Белгіленімді кез келген редактормен немесе сайт генераторымен HTML-ге шығарыңыз — бұл қадам сізде қалады.
- Бәрін бір файлға жинаңыз: стильдер style тегіне, суреттер base64 түрінде немесе абсолютті мекенжаймен.
- Беттің қай жерде бітетіні маңызды болса, бөлінуді стильдегі басып шығару ережелерімен нақты беріңіз.
- .html файлын бізге жүктеңіз: жиегі 0,4 дюймдік A4 және код блоктарының басылған фоны шығады.
- .md файлын бірде-бір маршрутымыз қабылдамайды — ол кеңейтімі бойынша қайтарылады.
Жиі қойылатын сұрақтар
Бір файлдан шыққан PDF неге әртүрлі көрінеді?
Себебі түрді белгіленім емес, көрсететін бағдарламаның стильдері береді. Редактор, сайт генераторы және қараушы әртүрлі қаріп пен баған ені қолданады, содан бет саны мен үзіліс орындары да басқаша болады.
.md файлын сіздерге тікелей жүктеуге бола ма?
Жоқ, маршрут тек .html және .htm қабылдайды. Алдымен белгіленімді өзіңіз жазатын редакторда HTML-ге шығарыңыз, ал сол HTML-ді PDF-ке басуды біз жасаймыз.
.md файлын жай ғана .html деп қайта атасақ не болады?
Файл жүктеледі, себебі HTML мазмұны алғашқы байттармен тексерілмейді. Бірақ ішінде тег жоқ, сондықтан PDF-те белгілері көрініп тұрған тұтас мәтін боласыз: тақырыптар торкөзді жол болып қала береді.
Жиек пен парақ өлшемін қалай беруге болады?
HTML ішіндегі стильдердің басып шығару ережелерімен — олар парақ пішімін, бағдарын және шегіністерін көрсетуге мүмкіндік береді. Ештеңе көрсетілмесе, біздің баптауымыз қолданылады: кітаптық A4 және 0,4 дюймдік жиек.