smanjenje

Uvod u Markdown

Uvod u Markdown

Uvod u Markdown

Smanjenje

Markdown je alat za pretvorbu teksta u HTML. Danas je postao de facto sinonim za klasu laganih jezika za opis oznaka. Koristi sintaksu formatiranja običnog teksta. Ideja koja stoji iza Markdowna bila je olakšati pisanje web stranica, a posebno unosa na blogu kao pisanje e-pošte. U vrijeme studenoga 2017. cilj je postignut i Markdown kao i njegove izvedenice Asciidoc, Asciidoctor i Asciidoctor-pdf su u širokoj upotrebi.

Markdown se usredotočuje samo na običan tekst i suzdržava se od svih ostalih složenosti koje se nalaze u HTML-u. Lako je naučiti jer je jednostavan, a time i brži jer se koriste minimalni znakovi, što na kraju dovodi do manje šanse za pogrešku. Pogledajte sliku 1 za osnovni dokument prikazan u Markdown uređivaču Stackedit. Na lijevoj strani vidite izvorni kod, a na desnoj strani odgovarajući HTML izlaz. Možda ćete primijetiti da su naslovi jednostavno označeni brojem # u skladu s hijerarhijskom razinom naslova.

Pretvorba teksta

Obični tekst može se pretvoriti u XHTML (HTML) i mnoge druge formate pomoću alata naredbenog retka poput Markdown ili Pandoc. U osnovi, oba alata stvaraju samo HTML fragmente i zapisuju izlaz u stdout. Pandoc nudi preklopnik "-o naziv datoteke" za upisivanje HTML izlaza u datu datoteku. Kao što se vidi ispod, izlazna datoteka naziva se osnovna.html i sadrži HTML fragment - dva naslova i odlomak.

$ pandoc -o osnovno.html osnovni.md $ mačka osnovna.html 
Kako napraviti Debian paket
 
Predgovor
 Biti odgovoran za stroj znači voditi brigu o hardveru kao i o softverskim komponentama. Kao što se u svakodnevnom životu vidi kao sistemski administrator, puno je bolje instalirati softver kao softverski paket, a ne kao hrpu izvornih datoteka. To smanjuje troškove za pravilno održavanje sustava. $

Da bi stvorio samostalne HTML dokumente s cjelovitim HTML zaglavljem, Pandoc prihvaća preklopku "-s" na sljedeći način:

$ pandoc -o osnovno.html -s osnovni.md $ mačka osnovna.html        <style>   
Kako napraviti Debian paket
 
Predgovor
 Biti odgovoran za stroj znači voditi brigu o hardveru kao i o softverskim komponentama. Kao što se u svakodnevnom životu vidi kao administrator sustava, puno je bolje instalirati softver kao softverski paket, a ne kao hrpu izvornih datoteka. To smanjuje troškove pravilnog održavanja sustava.

Prednost zadržavanja sadržaja odvojenog od vašeg vizualnog prikaza je u tome što neće pokvariti izgled vašeg web mjesta. Verzija 1.0.1, koji su razvili John Gruber i Aaron Swartz objavljen je u prosincu 2004. godine i dostupan je kao besplatni softver (vidi poveznice na kraju ovog članka).

Elementi teksta

Naslovi

Prema odgovarajućoj razini HTML-a, naslovi su napisani s brojem #, kako slijedi:

# H1 ## H2 ### H3 #### H4 ##### H5 ###### H6

Za H1 i H2 prihvaćena su dva alternativna načina pisanja:

H1 == H2 --

Napominjemo da se broj znakova jednakosti ili crtica mora podudarati s brojem znakova naslova.

Isticanje teksta

Da bi se naglasio tekst podržani su ovi elementi:

Popisi

Markdown podržava neuređene i poredane popise. Poredani popisi započinju zvjezdicom, znakom plus ili minus. Poredani popisi samo počinju znamenkom. Da biste stvorili podliste, uvucite stavku liste u dva razmaka (Markdown, StackEdit) ili četiri razmaka (Pandoc) kao što vidite dolje:

1. voće * jabuka * banana 2. napitci + voda + mlijeko

Slike

Najlakši način je koristiti ugrađeni stil na sljedeći način:

![Logotip Debiana] (logotip debian.png “Debianov logotip”)

Ovo prikazuje referenciranu sliku. Čim pomaknete pokazivač miša preko slike, vidite odgovarajući tekst opisa.

Označavanje koda i sintakse

Postoje dvije varijante - ugrađeni kod i blokovi koda. Inline kôd uokviren je u tri povratne znakove poput "'print (" Hello, world!")" '. Blokovi koda također počinju i završavaju s tri povratna znaka, ali u zasebnim redovima kako slijedi:

"print (" Zdravo, svijete!")"

Markdown ne podržava isticanje sintakse, ali dijalekti poput Markdown Here podržavaju.

Stolovi

Markdown ne podržava tablice, ali proširenja poput GFM-a i Markdown-a ovdje podržavaju.

Blok citati

Blok citati samo počinju znakom ">". Citiranje teksta postaje vrlo zgodno.

> "Oh! apsurdno je imati tvrdo i brzo pravilo o tome što treba> čitati, a što ne. Više od polovice moderne kulture ovisi> o onome što se ne smije čitati.">> Važnost iskrenosti. (Oscar Wilde)

Veze

Poveznice se odnose na druge dokumente ili na odjeljke u trenutnom. Stil pisanja sličan je slikama i sastoji se od opisa veze u uglastim zagradama i URL-a u redovitim zagradama.

[Ja sam veza u stilu] (https: // linuxhint.com)

Nadalje, možete dodati alternativni tekst:

[Ja sam veza u stilu s dodatnim tekstom] (https: // linuxhint.com “LinuxHint”)

Na linkove se može uputiti kako slijedi:

[LinuxHint] [1] ... malo teksta ... [1]: https: // linuxhint.com

To vam omogućuje lako stvaranje popisa referenci na kraju vašeg dokumenta, kao što je to uobičajeno u znanstvenim dokumentima.

Zaključak

Markdown je prilično jednostavan i nužan za sve koji rade dokumentaciju i redovito objavljuju sadržaj. Veliko je zadovoljstvo koristiti ga.

Reference

Miš Top 5 ergonomskih proizvoda za računalni miš za Linux
Top 5 ergonomskih proizvoda za računalni miš za Linux
Uzrokuje li dugotrajno korištenje računala bolove u zapešću ili prstima? Patite li od ukočenih zglobova i stalno se morate rukovati? Osjećate li goruć...
Miš How to Change Mouse and Touchpad Settings Using Xinput in Linux
How to Change Mouse and Touchpad Settings Using Xinput in Linux
Most Linux distributions ship with “libinput” library by default to handle input events on a system. It can process input events on both Wayland and X...
Miš Zamijenite svoje tipke miša različito za različiti softver pomoću X-Mouse Button Control
Zamijenite svoje tipke miša različito za različiti softver pomoću X-Mouse Button Control
Možda vam treba alat koji bi mogao promijeniti kontrolu miša sa svakom aplikacijom koju koristite. Ako je to slučaj, možete isprobati aplikaciju pod n...