Markdown

Z Wikipedie, otevřené encyklopedie
Markdown
[[Soubor:Markdown-mark|200px|]]
Vznik25. března 2004[1]
VývojářJohn Gruber
Poslední verze1.0.1 (17. prosince 2004)
LicenceAno[2]
Webdaringfireball.net/projects/markdown

Markdown je odlehčený značkovací jazyk, který slouží pro úpravu prostého textu a jeho následný převod na formátovaný text publikovatelný na webu, zejména ve formátu HTML. Umožňuje pomocí jednoduchých formátovacích značek vyznačit v textu nadpisy a seznamy, doplnit odkazy, obrázky atd. Cílem jazyka je, aby byl text dobře čitelný a publikovatelný i v původním formátu prostého textu.[1]

Markdown vytvořil John Gruber s pomocí Aarona Swartze,[3] hlavní inspirací byl formát prostého textu e-mailu.[1]

Historie a použití

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 jako jsou například PHP nebo Python. Používá se i u popisu dokumentace nebo jiných poznámek na GitHubu (implicitním popisem je obsah souboru README.md).

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

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á vlastnost implementovaná, může uživatel použít přímý zápis v HTML.

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

Rozšíření

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 Markdown 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

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

Příklad užití

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č.

Zdrojový text ve formátu jazyka Markdown Zdrojový text ve formátu HTML Text zobrazený v prohlížeči
Hlavní nadpis
==========

* toto
* je
* seznam

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

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

# Hlavní nadpis jinak

## Menší nadpis jinak

### Ještě menší nadpis jinak

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)

Horizontální oddělovač:
---

Vlastnosti textu _kurzíva_, *kurzíva*, __tučně__, **tučně**, `neproporcionální`.

<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>

<h1>Hlavní nadpis jinak</h1>

<h2>Menší nadpis jinak</h2>

<h3>Ještě menší nadpis jinak</h3>

<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>

Horizontální oddělovač:
<hr>

Vlastnosti textu <i>kurzíva</i>, <i>kurzíva</i>, <b>tučně</b>, <b>tučně</b>, <code>neproporcionální</code>.

<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ží

Hlavní nadpis jinak

Menší nadpis jinak

Ještě menší nadpis jinak

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

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

Horizontální oddělovač:


Vlastnosti textu kurzíva, kurzíva, tučně, tučně, neproporcionální.

Dle libosti můžu používat html

Nebo obrázek


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

http://cs.wikipedia.org

Odkazy

Reference

  1. a b c Daring Fireball: Markdown [online]. Web.archive.org [cit. 2014-04-25]. Dostupné online. 
  2. Markdown: License [online]. Daring Fireball [cit. 2014-04-25]. Dostupné online. 
  3. http://www.aaronsw.com/weblog/001189
  4. https://github.com/fletcher/MultiMarkdown
  5. http://michelf.ca/projects/php-markdown/
  6. http://pythonhosted.org//Markdown/

Související

  • BlueGriffon - HTML editor, který umožňuje vkládat Markdown