Увод у Маркдовн

Маркдовн

Маркдовн је алат за претварање текста у ХТМЛ. Данас је постао де фацто синоним за класу лаганих језика за опис ознака. Користи синтаксу форматирања обичног текста. Идеја која стоји иза Маркдовна била је олакшати писање веб страница, а посебно уноса на блогу као писање е-поште. У време новембра 2017. циљ је постигнут и Маркдовн као и његове изведенице Асциидоц, Асциидоцтор и Асциидоцтор-пдф су у широкој употреби.

Маркдовн се фокусира само на обичан текст и суздржава се од свих осталих сложености које се налазе у ХТМЛ-у. Лако је научити јер је једноставан, а самим тим и бржи јер се користе минимални знакови, што на крају доводи до мање шансе за грешку. Погледајте слику 1 за основни документ приказан у Маркдовн уређивачу Стацкедит. На левој страни видите изворни код, а на десној страни одговарајући ХТМЛ излаз. Можда ћете приметити да су наслови једноставно означени бројем # у складу са хијерархијским нивоом наслова.

Конверзија текста

Обични текст се може конвертовати у КСХТМЛ (ХТМЛ) и многе друге формате помоћу алата за командну линију попут Маркдовн или Пандоц. У основи, оба алата стварају само ХТМЛ фрагменте и записују излаз у стдоут. Пандоц нуди прекидач „-о име датотеке“ да напише ХТМЛ излаз у дату датотеку. Као што се види испод, излазна датотека се назива основним.хтмл и садржи ХТМЛ фрагмент - два наслова и пасус.

$ пандоц -о основно.хтмл басиц.мд $ мачка основна.хтмл 
Како направити Дебиан пакет
 
Предговор
 Бити одговоран за машину значи водити рачуна о хардверу као и о софтверским компонентама. Као што се у свакодневном животу види као системски администратор, много је боље инсталирати софтвер као софтверски пакет, а не као гомилу изворних датотека. Ово смањује трошкове за правилно одржавање система. $ 

Да би створио самосталне ХТМЛ документе са комплетним ХТМЛ заглављем, Пандоц прихвата преклопник -с на следећи начин:

$ пандоц -о основно.хтмл -с басиц.мд $ мачка основна.хтмл           
Како направити Дебиан пакет
 
Предговор
 Бити одговоран за машину значи водити рачуна о хардверу као и о софтверским компонентама. Као што се у свакодневном животу види као системски администратор, много је боље инсталирати софтвер као софтверски пакет, а не као гомилу изворних датотека. Ово смањује трошкове за правилно одржавање система.   

Предност држања садржаја одвојеног од визуелног приказа је у томе што неће нарушити изглед ваше веб локације. Верзија 1.0.1, који су развили Јохн Грубер и Аарон Свартз, објављен је у децембру 2004. године и доступан је као бесплатни софтвер (погледајте везе на крају овог чланка).

Елементи текста

Наслови

Према одговарајућем ХТМЛ нивоу, наслови се пишу са бројем #, како следи:

# Х1 ## Х2 ### Х3 #### Х4 ##### Х5 ###### Х6 

За Х1 и Х2 прихваћена су два алтернативна начина писања:

Х1 == Х2 -- 

Имајте на уму да број знакова једнакости или цртица мора одговарати броју знакова наслова.

Истицање текста

Да би се нагласио текст подржани су ови елементи:

• курзив: једноструке звездице или појединачне доње црте
  --
  * важно * и _ такође важно_
  --
• подебљани текст: двоструке звездице или двоструке доње црте
  --
  ** важно ** и __ такође важно__
  --
• прецртани текст: двоструке тилде
  --
  ~~ текст ~~
  --

Листе

Маркдовн подржава неуређене и уређене листе. Поредане листе почињу звездицом, знаком плус или минус. Поредане листе само почињу цифром. Да бисте креирали подлисте, увуците ставку листе у два размака (Маркдовн, СтацкЕдит) или четири размака (Пандоц) као што видите доле:

1. воће * јабука * банана 2. пића + вода + млеко 

Слике

Најлакши начин је да користите уграђени стил на следећи начин:

![Логотип Дебиан] (логотип дебиан.пнг „логотип Дебиан“) 

Ово приказује референцирану слику. Чим померите показивач миша преко слике, видећете одговарајући текст описа.

Означавање кода и синтаксе

Постоје две варијанте - уграђени код и блокови кода. Инлине код је уоквирен у три повратне знакове попут „'принт („ Здраво, свете!”)„ '. Блокови кода такође почињу и завршавају се са три повратна знака, али у одвојеним редовима, како следи:

"принт (" Здраво, свете!”)"

Маркдовн не подржава истицање синтаксе, али дијалекти попут Маркдовн Хере подржавају.

Столови

Маркдовн не подржава табеле, али проширења попут ГФМ и Маркдовн Хере подржавају.

Блоцккуотес

Блок цитати само почињу знаком „>“. Цитирање текста постаје прилично згодно.

> "Ох! апсурдно је имати тврдо и брзо правило о томе шта треба> читати, а шта не. Више од половине модерне културе зависи> од онога што не треба читати.">> Важност озбиљности. (Осцар Вилде) 

Везе

Везе се односе на друге документе или на одељке у тренутном. Стил писања сличан је сликама и састоји се од описа везе у угластим заградама и УРЛ-а у редовним заградама.

[Ја сам веза у стилу] (хттпс: // линукхинт.цом) 

Даље, можете додати алтернативни текст:

[Ја сам веза у стилу са додатним текстом] (хттпс: // линукхинт.цом „ЛинукХинт“) 

Линкови се могу позивати на следећи начин:

[ЛинукХинт] [1]… неки текст… [1]: хттпс: // линукхинт.цом 

То вам омогућава да лако направите листе референци на крају документа, као што је то уобичајено у научним документима.

Закључак

Маркдовн је прилично једноставан и неопходан за све који раде документацију и редовно објављују садржај. Велико је задовољство користити га.

Референце

• СтацкЕдит, хттпс: // стацкедит.ио / едитор
• Пандоц, хттп: // пандоц.орг /
• Маркдовн, хттпс: // дарингфиребалл.нет / пројецтс / маркдовн /
• Маркдовн Цхеатсхеет, хттпс: // гитхуб.цом / адам-п / маркдовн-хере / вики / Маркдовн-Цхеатсхеет