Markdown

Z Wikipedie, otevřené encyklopedie
Skočit na: Navigace, Hledání
{{{název}}}
Markdown-mark
Vznikl v: 25. března 2004[1]
Vývojář: John Gruber
Poslední verze: .md, .markdown[2]
/ 17. prosince 2004
Poslední nestabilní verze: 1.0.1 /
Licence: Ano[3]
Web: [1]

Markdown je jednoduchý formát textového souboru, který slouží pro následný převod do formátu HTML (existují i převodníky do dalších formátů). Umožňuje pomocí jednoduchých formátovacích značek zapsat do textu nadpisy, seznamy, odkazy, obrázky atd.

Historie a použití[editovat | editovat zdroj]

Jazyk byl původně vytvořen v roce 2004 Johnem Gruberem jako jednoduchý značkovací jazyk pro převod textu do validního XHTML nebo HTML. Jazyk byl původně implementován v programovacím jazyku Perl ale postupně se rozšířil a je znám a používán i v jiných jazycích jakou jsou například PHP nebo Python.

Markdown je velice oblíbeným nástrojem pro blogování, protože umožňuje velice jednoduše vytvářet odkazy a vkládat obrázky. Některé redakční systémy umožňují vkládat obsah právě pomocí Markdown. Lze ho použít také jako nástroj pro psaní knih nebo poznámek. Protože se jedná o prostý text je možné pro vytváření dokumentů použít libovolný editor.

Vlastnosti[editovat | editovat zdroj]

Jazyk je jednoduchý, přehledný a jeho syntax se chová očekávaně. Jazyk umožňuje kombinovat text a (X)HTML takže tam kde není určitá vlast implementovaná může uživatel použít přímý zápis v HTML.

Markdown také rozpozná a automaticky vkládá HTML entity.

Rozšíření[editovat | editovat zdroj]

Existuje rozšířená syntaxe, které implementuje vlastnosti, které původní Markdown nezahrnoval. Obecně se tato rozšíření označují jako Markdown Extra. Ten umožňuje oproti původnímu Markdown například:

  • Vkládat Mardown do HTML bloků (původní Markdow umožňoval

pouze vkládání HTML bloků do Markdown-u).

  • Elementy s id/class atributy
  • Definiční seznamy
  • Poznámky pod čarou
  • Tabulky
  • ... atd.

Implementace[editovat | editovat zdroj]

Původní implementace je pro programovací jazyk Perl. Nejznámnější jsou tyto implementace:

Příklad užití[editovat | editovat zdroj]

Následující text ukazuje Markdown v akci. Vlevo je zdrojový text. Vpravo je zdrojový text převeden do HTML a dole je podoba kterou textu dá např. webový prohlížeč.

Hlavní nadpis
==========

* toto
* je
* seznam

Menší podnadpis
---------------

1. toto 
2. se čísluje
1. ale na číslech nezáleží

Odstavce se oddělují
prázdným řádkem. Na délce řádků nezáleží

Udělám nový odstavec. Ještě odkaz na 
[dokumentaci](http://daringfireball.net/projects/markdown/syntax)


<p>Dle libosti <em>můžu používat</em> html</p>

Nebo obrázek 
![Alt text](https://commons.wikimedia.org/wiki/File:Markdown-mark.svg)

[odstavec]: http://cs.wikipedia.org/wiki/odstavec

Konec řádku uprostřed [odstavce][odstavec]      
se udělá  
pomocí několika mezer na konci řádku.

<http://cs.wikipedia.org>

<h1>Hlavní nadpis</h1>
 
<ul>
<li>toto</li>
<li>je</li>
<li>seznam</li>
</ul>
 
<h2>Menší podnadpis</h2>
 
<ol>
<li>toto </li>
<li>se čísluje</li>
<li>ale na číslech nezáleží</li>
</ol>
 
<p>Odstavce se oddělují
prázdným řádkem. Na délce řádků nezáleží</p>
 
<p>Udělám nový odstavec. Ještě odkaz na 
<a href="http://daringfireball.net/projects/markdown/syntax">dokumentaci</a></p>
 
<p>Dle libosti <em>můžu používat</em> html</p>
 
<p>Nebo obrázek 
<img alt="Alt text" src="https://commons.wikimedia.org/wiki/File:Markdown-mark.svg" /></p>
 
<p>Konec řádku uprostřed <a href="http://cs.wikipedia.org/wiki/odstavec">odstavce</a>    <br />
se udělá<br />
pomocí několika mezer na konci řádku.</p>
 
<p><a href="http://cs.wikipedia.org">http://cs.wikipedia.org</a></p>

Hlavní nadpis

  • toto
  • je
  • seznam

Menší podnadpis

  1. toto
  2. se čísluje
  3. ale na číslech nezáleží

Odstavce se oddělují prázdným řádkem. Na délce řádků nezáleží

Udělám nový odstavec. Ještě odkaz na dokumentaci

Dle libosti můžu používat html

Nebo obrázek Markdown-mark.svg


Konec řádku uprostřed odstavce
se udělá
pomocí několika mezer na konci řádku.

http://cs.wikipedia.org

Reference[editovat | editovat zdroj]

  1. Daring Fireball: Markdown [online]. Web.archive.org, [cit. 2014-04-25]. Dostupné online. (anglicky) 
  2. Daring Fireball Statement by creator John Gruber
  3. Markdown: License [online]. Daring Fireball, [cit. 2014-04-25]. Dostupné online. (anglicky)