Vytvoření nové poznámky

  • Klikni na tlačítko ➕ Nová poznámka a zadej název.
  • Položka se objeví v seznamu. Klikem načteš název a obsah do editoru nahoře.
  • Uprav obsah a klikni Uložit nyní.

Slash Command - Rychlá nápověda příkazú

1. Napíšete / v editoru → objeví se menu s příkazy
2. Filtrování Menu se filtruje podle dalšího textu (např. `/da` zobrazí `/date`)
3. Navigace:
↓↑ = Pohyb nahoru/dolů v menu
Enter/Tab = Výběr aktuálního příkazu
Escape = Zavření menu
4. Kliknutí na příkaz Vložení na místo kurzoru
5. Automatické zavření když kliknete mimo

Dostupné slash commands:

    /date - Vložit dnešní datum (📅)
    /time - Vložit čas (🕐)
    /code - Inline kód (💻)
    /codeblock - Blok kódu (📝)
    /link - Vložit odkaz (🔗)
    /image - Vložit obrázek (🖼)
    /table - Vložit tabulku (▦)
    /quote - Citace (❝)
    /hr - Vodorovná čára (—)
    /task - Úkol/checkbox (☐)
    /list - Odrážkový seznam (•)
    /h1 - H1 Nadpis
    /h2 - H2 Nadpis
    /h3 - H3 Nadpis

Tagy

Tagy jsou slova nebo fráze, která popisuje obsah poznámky. V aplikaci Doxa díky nim můžete filtrovat poznámky podle tagu.

Klikni do pole tagy a zadej název tagu (uloží se stejně s poznámkou).

Poznámku pomocí tagu pak vyhledáš v poli s lupou Filtrovat poznámky podle tagu...

Editace a mazání

Inline: klikni na poznámku, uprav obsah a stiskni Uložit nyní.

Modal: klikni na ikonu ✎ vedle položky pro pokročilou editaci v modal okně.

Mazání: ikona 🗑 u položky — po potvrzení se poznámka smaže.

Přesouvání pořadí poznámek

Použij šipky ↑ / ↓ u položek.

Nebo přetahuj položky (drag & drop) na požadované místo — při přetažení se ukáže indikátor vložení.

Přepínání vzhledu

V horním menu najdeš tlačítko pro přepínání vzhledu. Aplikace podporuje tři režimy:

  • Světlý — ikona: ☀️
  • Tmavý — ikona: 🌙
  • Respektovat systém — ikona: 🌓 — aplikace bude sledovat systémovou volbu (prefers-color-scheme) a automaticky se přepne, pokud se změní systémový motiv.

Kliknutím na tlačítko v menu cyklíš mezi režimy (Light → Dark → System). Vybraná volba se uloží do localStorage pod klíčem doxa_theme a přetrvá mezi stránkami a obnovami. Pokud chceš volbu resetovat, otevři konzoli prohlížeče a spusť: localStorage.removeItem('doxa_theme') nebo vymaž storage v nástrojích pro vývojáře.

Automatické ukládání

Aplikace nyní automaticky ukládá změny poznámek lokálně během psaní (autosave). V běžném prohlížeči se změny ukládají do localStorage (klíč doxa_notes_v1) bez nutnosti manuálního ukládání — data se uloží po krátké prodlevě. Pokud aplikaci spouštíš v Electron/Node režimu, změny se zapisují přímo do lokálního souboru.

Průběžně si úkládej i JSON soubor manuálně!!

Manuální uložení

Vedle editoru najdeš tlačítko Uložit nyní. I když autosave ukládá průběžně, tlačítko je užitečné v těchto případech:

  • Okamžité uložení — provede persist bez čekání na autosave (užitečné před zavřením aplikace nebo pokud chcete rychlou jistotu, že jsou změny zapsány).
  • Vizuální potvrzení — po uložení se zobrazí stav „Uloženo“, což dává uživateli okamžitou zpětnou vazbu.
  • Bez stažení — tlačítko Uložit poznámku neprovádí stažení souboru; pokud chcete stáhnout JSON, použijte tlačítko Exportovat JSON.

Pro přenos dat mezi zařízeními použijte tlačítko Exportovat JSON (stáhne soubor doxa.json), nebo z konzole spusťte saveNotesToFile(true).

Import / Export

Pro import klikni Importovat JSON a vyber soubor. Podporované formáty:

  • Objekt s polem notes: { "notes": [ ... ] }
  • Přímo pole: [ { ... }, { ... } ]

Export je nyní dostupný přes tlačítko Exportovat JSON (vedle tlačítka Uložit). Aplikace zároveň provádí autosave lokálně — nic neztratíte, pokud zapomenete manuálně uložit. Chcete-li stáhnout JSON přes skript, můžete také spustit v konzoli saveNotesToFile(true).

Export do Markdown

Jednotlivou poznámku si můžete exportovat do Markdown.

Export je v formátu názevPoznámky.md

Bezpečnost a zálohy

Výchozí režim je local‑first: data zůstávají ve tvém prohlížeči (localStorage) nebo lokálním souboru, aplikace je sama neodesílá.

Časté problémy

  • Při otevírání přes file:// může fetch statického JSONu selhávat — použij lokální server nebo Electron.
  • Přenos dat mezi zařízeními? Stáhni JSON a importuj ho na druhém zařízení.

Markdown

Editor používá Markdown

Editor pracuje s Markdown syntaxí. Všechny úpravy se ukládají jako Markdown (čistý text) — náhled ukazuje vykreslené HTML. Níže základní příklady (vložte je přímo do editoru nebo použijte tlačítka v toolbaru):

Tučné: **tučný text**
Kurzíva: *kurzíva*
Přeškrtnutí: ~~přeškrtnuté~~
Inline kód: `kód`
Kódový blok:

console.log('hello')

Nadpisy:
# Nadpis H1
## Nadpis H2
### Nadpis H3
Seznam (odrážky):
- položka 1
- položka 2
Číslovaný seznam:
1. první
2. druhý
Citace:
> Toto je citace
Tabulka:
| Sloupec 1 | Sloupec 2 |
| --- | --- |
| bunka 1 | bunka 2 |
| bunka 3 | bunka 4 |
Obrázek (referenční URL):
![alt text](https://example.com/obrazek.png)
Odkaz:
[text](https://example.com)
Úkoly (task list):
- [ ] nedokončeno
- [x] hotovo

Důležité tipy:

  • Kliknutím na tlačítka v toolbaru vložíte potřebné Markdown tokeny automaticky.
  • Stiskněte Ctrl/Cmd+B pro tučné, Ctrl/Cmd+I pro kurzívu a Ctrl/Cmd+` pro inline kód.
  • Tlačítko Náhled přepne vykreslení Markdownu; používejte jej k ověření výsledku.
  • Tlačítko Tabulka (▦) vloží šablonu tabulky a během vložení vás vyzve na počet sloupců a řádků.
  • Obrázky vkládejte jako URL — aplikace obrázky nesynchronizuje ani nahrává.
  • Markdown je přenosný: poznámky zůstávají čitelné i bez aplikace (export/import).