Uvod v Markdown

Markdown

Markdown je orodje za pretvorbo besedila v HTML. Danes je dejansko postal sinonim za razred lahkih označevalnih jezikov. Uporablja sintakso za oblikovanje navadnega besedila. Zamisel Markdowna je bila, da bi bilo pisanje spletnih strani in zlasti vnosov v bloge tako enostavno kot pisanje e-pošte. V novembru 2017 je cilj dosežen in Markdown ter njegove izpeljanke Asciidoc, Asciidoctor in Asciidoctor-pdf se pogosto uporabljajo.

Markdown se osredotoča samo na navadno besedilo in se vzdrži vseh drugih zapletenosti, kot jih najdemo v HTML-ju. Enostavnega učenja je, saj je preprosto, zato tudi hitrejše, saj se uporabljajo minimalni znaki, kar na koncu vodi tudi do manj možnosti za napako. Glejte sliko 1 za osnovni dokument, prikazan v urejevalniku Markdown Stackedit. Na levi strani vidite izvorno kodo, na desni pa ustrezen izhod HTML. Morda boste opazili, da so naslovi preprosto označeni s številkami # glede na hierarhično raven naslova.

Pretvorba besedila

Navadno besedilo je mogoče pretvoriti v XHTML (HTML) in številne druge formate z uporabo orodij ukazne vrstice, kot sta Markdown ali Pandoc. V bistvu obe orodji ustvarjata samo fragmente HTML in zapisujeta izhod v stdout. Pandoc ponuja stikalo “-o ime datoteke” za zapisovanje izhoda HTML v dano datoteko. Kot je razvidno spodaj, je izhodna datoteka poimenovana osnovna.html in vsebuje fragment HTML - dva naslova in odstavek.

$ pandoc -o osnovno.html osnovno.md $ mačka osnovno.html 
Kako ustvariti paket Debian
 
Predgovor
 Odgovornost za stroj pomeni skrb za strojno opremo in komponente programske opreme. Kot je v vsakdanjem življenju videti kot sistemski skrbnik, je veliko bolje namestiti programsko opremo kot programski paket in ne kot kup izvornih datotek. To zmanjšuje stroške pravilnega vzdrževanja sistema. $ 

Če želite ustvariti samostojne dokumente HTML s popolno glavo HTML, Pandoc sprejme stikalo "-s", kot sledi:

$ pandoc -o osnovno.html -s osnovno.md $ mačka osnovno.html           
Kako ustvariti paket Debian
 
Predgovor
 Odgovornost za stroj pomeni skrb za strojno opremo in komponente programske opreme. Kot je v vsakdanjem življenju videti kot sistemski skrbnik, je veliko bolje namestiti programsko opremo kot programski paket in ne kot kup izvornih datotek. To zmanjša stroške pravilnega vzdrževanja sistema.   

Prednost ločevanja vsebine od vizualnega prikaza je v tem, da ne bo motila videza vašega spletnega mesta. Različica 1.0.1, ki sta ga razvila John Gruber in Aaron Swartz, je izšel decembra 2004 in je na voljo kot brezplačna programska oprema (glej povezave na koncu tega članka).

Elementi besedila

Naslovi

Glede na ustrezno raven HTML so naslovi napisani s številkami #, kot sledi:

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

Za H1 in H2 sta sprejeta dva alternativna načina pisanja:

H1 == H2 -- 

Upoštevajte, da se mora število enakovrednih znakov ali pomišljajev ujemati s številom znakov naslova.

Poudarjanje besedila

Za poudarjanje besedila so podprti ti elementi:

• ležeče: enojne zvezdice ali posamezne podčrtaje
  --
  * pomembno * in _pomembno_
  --
• krepko besedilo: dvojne zvezdice ali dvojne podčrtaje
  --
  ** pomembno ** in __ tudi pomembno__
  --
• prečrtano besedilo: dvojne tilde
  --
  ~~ besedilo ~~
  --

Seznami

Markdown podpira neurejene in urejene sezname. Razvrščeni seznami se začnejo z zvezdico, znakom plus ali minus. Razvrščeni seznami se začnejo samo s številko. Če želite ustvariti pod sezname, vstavite element seznama v dva presledka (Markdown, StackEdit) ali štiri presledke (Pandoc), kot vidite spodaj:

1. sadje * jabolko * banana 2. pijače + voda + mleko 

Slike

Najlažji način je, da uporabite vrstni slog, kot sledi:

![Logotip Debian] (logotip debian.png »logotip Debian«) 

To prikaže referenčno sliko. Takoj, ko premaknete kazalec miške nad sliko, vidite ustrezno opisno besedilo.

Označevanje kode in sintakse

Obstajata dve različici - vrstica in blok kode. Vstavljena koda je uokvirjena v tri povratne znake, kot je "'print (" Hello, world!")" '. Bloki kod se prav tako začnejo in končajo s tremi povratnimi znaki, vendar v ločenih vrsticah, kot sledi:

"print (" Pozdravljen, svet!”)"

Markdown ne podpira poudarjanja skladnje, dialekti, kot je Markdown Here, pa.

Mize

Markdown ne podpira tabel, ampak razširitve, kot sta GFM in Markdown Here.

Blok citati

Blok-narekovaji se začnejo samo z znakom »>«. Citiranje besedila postane zelo priročno.

> "Oh! nesmiselno je imeti hitro in hitro pravilo o tem, kaj naj> bere in česa ne. Več kot polovica sodobne kulture je odvisna> od tega, česa ne bi smeli brati.">> Pomen, kako biti iskren. (Oscar Wilde) 

Povezave

Povezave se nanašajo na druge dokumente ali na odseke v trenutnem. Slog pisanja je podoben slikam in je sestavljen iz opisa povezave v oglatih oklepajih in URL-ja v navadnih oklepajih.

[Sem povezava v vrstici] (https: // linuxhint.com) 

Poleg tega lahko dodate nadomestno besedilo:

[Sem povezava v vrstici z dodatnim besedilom] (https: // linuxhint.com »LinuxHint«) 

Povezave se lahko sklicujejo na naslednji način:

[LinuxHint] [1]… nekaj besedila… [1]: https: // linuxhint.com 

To vam omogoča enostavno sestavljanje referenčnih seznamov na koncu dokumenta, kot je to običajno v znanstvenih dokumentih.

Zaključek

Markdown je precej preprost in nujen za vsakogar, ki dela dokumentacijo in redno objavlja vsebino. V veliko veselje ga je uporabiti.

Reference

• StackEdit, https: // stackedit.io / urednik
• Pandoc, http: // pandoc.org /
• Markdown, https: // daringfireball.net / projects / markdown /
• Markdown Cheatsheet, https: // github.com / adam-p / markdown-here / wiki / Markdown-Cheatsheet