# Markdown cheatsheet

Na wiki jsou stránky psané ve variantě Markdownu, standardního textového jazyka pro lehce formátovaný text. Zde najdete příklady všech podporovaných funkcí.

## Vytváření stránek / Nahrávání souborů

Pro vytvoření nové stránky/souboru na wiki napište URL, pod kterou chcete, aby stránka/soubor existovala. Wiki vám vynadá, že stránka neexistuje, a nabídne vám ji vytvořit/nahrát soubor.

## Základní formátování

<{MultiColumn(2)}>
```
Odstavce jsou tvořené automaticky,
oddělujte je prázdným řádkem.

Pokud potřebujete zalomit řádek v odstavci,  
dejte na jeho konec dvě mezery.

Text obklopený *hvězdičkami* nebo _podtržítky_
je zvýrazněný, sázen kurzivou.

Text obklopený **dvěma hvězdičkami** či __podtržítky__
je sázen tučně.

Text obklopený ~~dvěma vlnovkami~~ je sázen přeškrtnutě.
```

<{Box(avoid-column-break)}>
Odstavce jsou tvořené automaticky,
oddělujte je prázdným řádkem.

Pokud potřebujete zalomit řádek v odstavci,  
dejte na jeho konec dvě mezery.

Text obklopený *hvězdičkami* nebo _podtržítky_
je zvýrazněný, sázen kurzivou.

Text obklopený **dvěma hvězdičkami** či __podtržítky__
je sázen tučně.

Text obklopený ~~dvěma vlnovkami~~ je sázen přeškrtnutě.
<{/Box}>
<{/MultiColumn}>

## Matematické výrazy

Wiki podporuje [KaTeX](https://katex.org/docs/supported.html).

<{MultiColumn(2)}>
```
Vzorce uvnitř odstavce stačí ohraničit dolary:
$x^2$.

Samostatné vzorce stačí ohraničit dvěma dolary:
$$\sum^n_{i=0}i^2$$
```
<{Box(avoid-column-break)}>
Vzorce uvnitř odstavce stačí ohraničit dolary:
$x^2$.

Samostatné vzorce stačí ohraničit dvěma dolary:
$$\sum^n_{i=0}i^2$$
<{/Box}>
<{/MultiColumn}>

## Odkazy

<{MultiColumn(2)}>
```
Odkazy se píší kombinací závorek, vlevo text,
vpravo URL: [O wiki](/O wiki)
```

Odkazy se píší kombinací závorek, vlevo text,
vpravo URL: [O wiki](/O wiki)
<{/MultiColumn}>

Místní odkazy (zpět do této wiki) pište bez domény, začínající lomítkem.

## Obrázky

<{MultiColumn(2)}>
```
Obrázky vypadají skoro jako odkazy, vlevo alt text,
vpravo URL:

![](/Kapely/ahmedmahlad.jpg)

Pomocí makra Box můžete omezit velikost obrázku:

<{Box(max-width=200)}>
![](/Malá strana/Plánek 1NP.svg)
<{/Box}>
```
<{Box(avoid-column-break)}>
Obrázky vypadají skoro jako odkazy, vlevo alt text,
vpravo URL:

![](/Kapely/ahmedmahlad.jpg)

Pomocí makra Box můžete omezit velikost obrázku:

<{Box(max-width=200)}>
![](/Malá strana/Plánek 1NP.svg)
<{/Box}>
<{/Box}>
<{/MultiColumn}>

Alt text (v hranatých závorkách) můžete s klidem vynechat, pokud vám není líto nevidomých.

Pro nahrání nových obrázků můžete nejprve vložit neexistující obrázek (viz výše). Wiki vám místo obrázku zobrazí odkaz pro nahrání.

## Seznamy

<{MultiColumn(2)}>
```
Seznamy jsou buď nečíslované:

- jako
- tento

nebo číslované:

1. třeba
2. takto

- můžete je i
  - zanořovat
- pomocí
  1. odsazení mezerami
```

Seznamy jsou buď nečíslované:

- jako
- tento

nebo číslované:

1. třeba
2. takto

- můžete je i
  - zanořovat
- pomocí
  1. odsazení mezerami
<{/MultiColumn}>

## Citace

<{MultiColumn(2)}>
```
> Citovaný text
> klidně na více řádků a může obsahovat makra i markdown

> Citace
>> Citace v Citaci
>>> Citace v citaci v citaci
>>
>> pokračování citace v citaci
>>
>
> pokračování vnější citace
```

<{Box(avoid-column-break)}>
> Citovaný text
> klidně na více řádků a může obsahovat makra i markdown

> Citace
>> Citace v Citaci
>>> Citace v citaci v citaci
>>
>> pokračování citace v citaci
>>
>
> pokračování vnější citace
<{/Box}>

<{/MultiColumn}>

## Tabulky

Tabulky se píší "ASCII grafikou". Jeden řádek hlavičky, jeden oddělovací a pak samotný obsah. Pozice či absence dvojtečky v oddělovacím řádku určuje zarovnání obsahu.

<{MultiColumn(2)}>
```
|Sloupec    |Další          | A ještě jeden |
|-----------|--------------:|:-------------:|
|Doleva     |Doprava        | Střed         |
|A další    |Delší pro efekt| ...           |

|-----------|--------------:|:-------------:|
|Tabulka    | Bez           | Hlavičky      |
```

|Sloupec    |Další          | A ještě jeden |
|-----------|--------------:|:-------------:|
|Doleva     |Doprava        | Střed         |
|A další    |Delší pro efekt| ...           |

|-----------|--------------:|:-------------:|
|Tabulka    | Bez           | Hlavičky      |

<{/MultiColumn}>

## Dělící čáry

<{MultiColumn(2)}>
```
Ano,

---

i to wiki umí.
```
Ano,

---

i to wiki umí.
<{/MultiColumn}>

## Checkboxy

<{MultiColumn(2)}>
```
- [ ] takto se píše nechecknutý checkbox
- [x] a takto checknutý
```

- [ ] takto se píše nechecknutý checkbox
- [x] a takto checknutý
<{/MultiColumn}>

## Makra

Tato wiki má možnost používat makra pro komplexnější konstrukty, například jako částečnou náhradu HTML tagů používaných třeba na Wikipedii. Přehled všech maker najdete ve [zdrojovém kódu](https://gitlab.mff.cuni.cz/matfyzak/wiki/-/tree/master/src/moin/macros), nebo se podívejte na [krátký přehled nejpoužívanějších maker](/Markdown makra).