# 📖 Markdown Viewer — uživatelská příručka

Vítejte v **Markdown Viewer** — multiplatformním prohlížeči Markdown souborů pro macOS i Windows. Tento dokument zároveň slouží jako ukázka všech podporovaných funkcí.

> Zkratky se píší jako **Cmd/Ctrl** — na macOS použij **Cmd (⌘)**, na Windows **Ctrl**.

## 🚀 Rychlý start

Vyzkoušej si hlavní funkce rovnou na tomto dokumentu:

- **Cmd/Ctrl+D** — přepnutí světlého / tmavého režimu
- **Cmd/Ctrl+F** — vyhledávání (zkus najít „funkce"); **F3** / **Cmd+G** další, **Shift+F3** / **Cmd+Shift+G** předchozí
- **Cmd/Ctrl+T** — postranní panel s obsahem (TOC)
- **Cmd/Ctrl** a **+** / **−** / **0** — zvětšení, zmenšení, výchozí velikost
- **F5** / **Cmd/Ctrl+R** — znovu načíst soubor z disku
- **Cmd/Ctrl+P** — tisk
- **Cmd/Ctrl+E** — export do PDF
- **ESC** — zavře vyhledávání (je-li otevřené), jinak ukončí aplikaci

## 🎨 Vizuální formátování

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

Markdown podporuje různé způsoby formátování:

- **Tučný text** pomocí `**text**`
- *Kurzíva* pomocí `*text*`
- ***Tučná kurzíva*** pomocí `***text***`
- ~~Přeškrtnutý text~~ pomocí `~~text~~`
- `Inline kód` pomocí \`text\`

### Nadpisy různých úrovní

Tento dokument používá nadpisy H1 až H3, které se automaticky zobrazují v panelu obsahu (Cmd/Ctrl+T).

## 📝 Seznamy a odrážky

### Nečíslovaný seznam

- První úroveň odrážek
  - Druhá úroveň odrážek
    - Třetí úroveň odrážek
  - Zpět na druhou úroveň
- Zpět na první úroveň

### Číslovaný seznam

1. První krok procesu
2. Druhý krok procesu
   1. Pod-krok 2.1
   2. Pod-krok 2.2
3. Třetí krok procesu
4. Čtvrtý a poslední krok

### Smíšený seznam

1. Číslovaná položka
   - Vnořená odrážka
   - Další odrážka
2. Další číslovaná položka
   - Odrážka
     - Ještě hlubší úroveň

## 💻 Bloky kódu

### JavaScript příklad

```javascript
// Funkce pro pozdrav
function greet(name) {
    console.log(`Ahoj, ${name}!`);
    return true;
}

// Použití
greet("světe");
```

### Python příklad

```python
# Třída pro správu uživatelů
class UserManager:
    def __init__(self):
        self.users = []

    def add_user(self, name):
        self.users.append(name)
        print(f"Uživatel {name} přidán")

# Vytvoření instance
manager = UserManager()
manager.add_user("Jan")
```

### Pascal příklad

```pascal
function Faktorial(N: Integer): Int64;
begin
  if N <= 1 then
    Result := 1
  else
    Result := N * Faktorial(N - 1);
end;

begin
  WriteLn('5! = ', Faktorial(5));
end.
```

## 📊 Tabulky

### Jednoduchá tabulka

| Funkce | Zkratka | Popis |
|--------|---------|-------|
| Tmavý režim | Cmd/Ctrl+D | Přepne světlý / tmavý režim |
| Vyhledávání | Cmd/Ctrl+F | Otevře panel vyhledávání |
| Obsah (TOC) | Cmd/Ctrl+T | Zobrazí postranní panel s nadpisy |
| Zvětšení / zmenšení | Cmd/Ctrl +/− | Zoom obsahu (0 = výchozí) |
| Tisk | Cmd/Ctrl+P | Otevře tiskový dialog |
| Export do PDF | Cmd/Ctrl+E | Uloží dokument jako PDF |
| Obnovení | F5 / Cmd/Ctrl+R | Znovu načte dokument ze souboru |
| Zavřít | ESC | Zavře vyhledávání nebo aplikaci |

### Komplexní tabulka

| Prvek | Syntax | Výsledek | Poznámka |
|-------|--------|----------|----------|
| Nadpis 1 | `# Text` | <h1>Největší</h1> | Hlavní nadpis |
| Nadpis 2 | `## Text` | <h2>Velký</h2> | Podnadpis |
| Tučný | `**text**` | **text** | Zvýraznění |
| Kurzíva | `*text*` | *text* | Zdůraznění |

## 📈 Mermaid diagramy

Bloky ```` ```mermaid ```` se vykreslí jako diagram (v okně i v exportu do PDF):

```mermaid
flowchart TD
    A[Start] --> B{Je soubor .md?}
    B -->|Ano| C[Načíst obsah]
    B -->|Ne| D[Zobrazit chybu]
    C --> E[Vykreslit Markdown]
    E --> F[Hotovo]
```

Sekvenční diagram:

```mermaid
sequenceDiagram
    participant U as Uživatel
    participant V as Viewer
    U->>V: Otevře .md soubor
    V-->>U: Zobrazí diagram
```

## 🖼️ Relativní obrázek

Obrázek načtený relativní cestou (funguje díky virtuálnímu hostu `md.local`):

![Ikona aplikace](app_icon.png)

## 💬 Citace

### Jednoduchá citace

> Toto je jednoduchá citace. Hodí se pro zvýraznění důležitého textu nebo citování jiných autorů.

### Vnořená citace

> Vnější citace
>
> > Vnořená citace
> >
> > > Ještě hlubší citace

### Citace s formátováním

> **Důležité:**
>
> - Markdown podporuje *formátování* uvnitř citací
> - Můžete použít **seznamy**
> - I `kód` funguje

## 🔗 Odkazy a reference

### Základní odkazy

- [GitHub](https://github.com)
- [Dokumentace Markdown](https://www.markdownguide.org/)
- [Tauri](https://tauri.app/)

### Odkazy s titulky

[Tento odkaz má tooltip](https://example.com "Najeďte na mě myší")

### Automatické odkazy

<https://www.example.com>

## ✅ Úkoly (Task list)

- [x] Základní zobrazení Markdownu (GFM tabulky, seznamy…)
- [x] Světlý / tmavý režim
- [x] Fulltextové vyhledávání
- [x] Postranní panel s obsahem (TOC)
- [x] Syntax highlighting kódu (190+ jazyků)
- [x] Mermaid diagramy a relativní obrázky
- [x] Tisk a export do PDF
- [ ] Automatické sledování změn souboru (plánováno)

## 🎯 Pokročilé funkce

### Horizontální čára

Můžete vytvořit oddělovač:

---

### Escape sekvence

Použijte \\ pro escapování speciálních znaků: \* \_ \` \#

### Inline HTML

<div style="background-color: #f0f0f0; padding: 10px; border-radius: 5px;">
Můžete také použít HTML pro pokročilé formátování!
</div>

## 📖 Vyzkoušejte funkce

### Vyhledávání (Cmd/Ctrl+F)

Zkuste vyhledat slovo **„funkce"** — objevuje se několikrát v tomto dokumentu. Mezi výsledky se pohybujete tlačítky „Další"/„Předchozí", klávesou **F3** (další) a **Shift+F3** (předchozí), na macOS i **Cmd+G** / **Cmd+Shift+G**. Panel zavřete klávesou **ESC** nebo tlačítkem „X".

### Tmavý režim (Cmd/Ctrl+D)

Přepněte mezi světlým a tmavým režimem a sledujte, jak se změní barvy:
- Pozadí
- Text
- Bloky kódu
- Tabulky
- Odkazy

Nastavení se ukládá — po příštím spuštění se aplikace otevře ve zvoleném režimu.

### Obsah / TOC (Cmd/Ctrl+T)

V postranním panelu uvidíte všechny nadpisy tohoto dokumentu. Kliknutím na nadpis se plynule přesunete na danou sekci. Šířku panelu lze měnit tažením za jeho okraj.

### Tisk a export do PDF (Cmd/Ctrl+P, Cmd/Ctrl+E)

**Tisk (Cmd/Ctrl+P)** otevře nativní tiskový dialog — dokument vytisknete, nebo uložíte jako PDF (na macOS přes nabídku *PDF ▸ Uložit jako PDF*, na Windows výběrem tiskárny *Microsoft Print to PDF*). Stránkuje se na formát A4 s okraji.

**Export do PDF (Cmd/Ctrl+E)** uloží PDF pojmenované podle .md souboru — na macOS přes tiskový dialog, na Windows přímo bez dialogu.

### Obnovení (F5 / Cmd/Ctrl+R)

Pokud soubor upravíte v editoru, stiskněte **F5** (nebo **Cmd/Ctrl+R**) pro okamžité načtení změn ze souboru.

### Rychlé zavření (ESC)

Stiskněte **ESC** pro rychlé zavření aplikace. Pokud je otevřený vyhledávací panel, první ESC ho zavře a druhé ESC zavře celou aplikaci.

## 🏆 Závěr

Gratulujeme! Nyní znáte všechny funkce **Markdown Viewer**.

### Co dál?

1. Vytvořte si vlastní Markdown dokumenty
2. Použijte tento viewer pro prohlížení README souborů
3. Exportujte dokumenty do PDF pro sdílení
4. Využívejte klávesové zkratky pro rychlejší práci

---

**Markdown Viewer** — multiplatformní prohlížeč Markdownu pro macOS a Windows (postavený na Tauri, marked.js, highlight.js a mermaid.js).