roam-markdown-rules.md

Roam Research Markdown - Konverzní pravidla

Základní struktura

Nadpisy

• Hlavní nadpis: - # Nadpis
• Pod-nadpis: - ## Nadpis
• Vždy začínají odrážkou - následovanou mezerou a markdown nadpisem

Hierarchie

• Používá odrážky - pro každou úroveň
• Odsazení: 4 mezery pro každou vnořenou úroveň
• Příklad:

- # Nadpis úrovně 1
    - ## Nadpis úrovně 2
        - Obsah úrovně 3
            - Obsah úrovně 4

Code bloky

• Syntax: trojité zpětné apostrofy s volitelnou specifikací jazyka
• Musí být odsazeny podle své úrovně v hierarchii
• Příklad:

- # Sekce
    - Popis
        - ```clojure
          (defn hello []
            (println "Hello"))
          ```

Tabulky - SPECIÁLNÍ PRAVIDLO

Struktura tabulky

1. První řádek definuje sloupce (názvy sloupců):

   - Název sloupce 1
       - Název sloupce 2
           - Název sloupce 3
   

   • První řádek by měl obsahovat tučné názvy sloupců

2. Následující řádky obsahují data:

   • První úroveň = hodnota pro sloupec 1
   • Druhá úroveň = hodnota pro sloupec 2
   • Třetí úroveň = hodnota pro sloupec 3

   - Data řádek 1, sloupec 1
       - Data řádek 1, sloupec 2
           - Data řádek 1, sloupec 3
   

3. DŮLEŽITÉ: Tag {{[[table]]}}:

   • Každá tabulka MUSÍ mít na nejvyšší úrovni osnovy tag {{[[table]]}}
   • Tag se přidá za nadpis

Příklad kompletní tabulky:

- # Key Differences Table {{[[table]]}}
    - Aspect
        - Initial Load
            - Hot-Reload
    - When?
        - Browser refresh, first visit
            - Every code save
    - `defonce`
        - ✅ Runs
            - ❌ Skipped

Formátování textu

Bold text

• **tučný text**

Inline kód

• `kód`

Emojis

• Podporovány nativně: ✅ ❌ 👆 atd.

Seznamy

Neuspořádané seznamy

• Používají odrážky - s odsazením podle úrovně
• Každá položka je samostatná odrážka

Příklad:

- # Main Section
    - ## Subsection
        - Item 1
        - Item 2
            - Nested item 2.1
            - Nested item 2.2

Checklist konverze

Při konverzi dokumentu do Roam formátu:

• Všechny nadpisy začínají - # nebo - ## nebo - ###
• Hierarchie používá 4 mezery na úroveň
• Code bloky mají specifikaci jazyka (clojure, bash, python, atd.)
• Tabulky mají správnou strukturu sloupců
• Tabulky mají tag {{[[table]]}} na nejvyšší úrovni
• Inline kód je v zpětných apostrofech
• Žádné prázdné řádky mezi odrážkami stejné úrovně

Poznámky

• Roam automaticky renderuje tabulky pouze s tagem {{[[table]]}}
• První řádek tabulky definuje sloupce, následující řádky jsou data
• Odsazení je KRITICKÉ - vždy 4 mezery, nikdy taby
• Code bloky moją být vnořené na jakékoli úrovni