diff --git a/readme.md b/readme.md
index bd0a669..0a5add0 100644
--- a/readme.md
+++ b/readme.md
@@ -58,4 +58,52 @@ _Text_ → Unterstrichen
>[c Sprache] Text> → Codeblock
>[q] Text> → Zitatblock
>[b] Text> → Bibel-Textblock
-```
\ No newline at end of file
+```
+
+
+# Simonhigh Syntax-Spezifikation
+
+Simonhigh ist eine moderne, fluss- und blockorientierte Auszeichnungssprache. Sie wurde entwickelt, um den Schreibfluss zu maximieren, die Finger-Akrobatik auf der Tastatur zu minimieren und die bekanntesten Schwachstellen von traditionellem Markdown elegant zu lösen.
+
+---
+
+## Philosophie: Fluss vs. Block
+
+Simonhigh trennt strikt zwischen zwei Logiken:
+1. **Fluss-Formatierungen (Inline):** Werden mit *einem* einzelnen Zeichen geöffnet und geschlossen. Sie erlauben es, Formatierungen mitten im Satz zu nutzen, ohne eine neue Zeile zu erzwingen (z. B. Inline-Überschriften). Sie funktionieren auch innerhalb von Blöcken.
+2. **Block-Formatierungen (Strukturell):** Beginnen *immer* am Zeilenanfang mit dem Kaufmanns-Und (`&`) plus einem Typ-Kürzel. Sie enden mit einem einzelnen `&` auf einer eigenen, neuen Zeile.
+
+---
+
+## 1. Fluss-Formatierungen (Inline)
+
+| Syntax | Ergebnis | Besonderheit / Usecase |
+| :--- | :--- | :--- |
+| `#Text#` | **Überschrift H1** | Text kann direkt in der Zeile weiterfließen. |
+| `##Text##` | **Überschrift H2** | Text kann direkt in der Zeile weiterfließen. |
+| `*Text*` | **Fett** | Starke Betonung / Auch für Tabellenköpfe. |
+| `/Text/` | *Kursiv* | Leichte Betonung / Zitate im Text. |
+| `_Text_` | Unterstrichen | Sauberer, dokumentenähnlicher Textstil. |
+| `~Text~` | ~~Durchgestrichen~~ | Korrekturen oder erledigte To-Dos. |
+| `=Text=` | Leuchtstift / Highlight | Textmarker-Effekt für wichtige Schlüsselwörter. |
+| `^Text^` | Hochgestellt | Mathematische Notation oder Indizes. |
+| `^^Text^^` | Tiefgestellt | Chemische Formeln oder Indizes. |
+| `` `Text` `` | `Inline-Code` | Technische Begriffe im Fließtext. |
+| `\Zeichen` | *Escape* | Hebt die Bedeutung von Steuerzeichen auf (z. B. `\#`). |
+
+### Ausrichtung & Einrückung im Fluss
+* `|Text|` → Der umschlossene Text wird **zentriert**.
+* `>Text>` → Der umschlossene Text wird **1x eingerückt**.
+* `>>Text>>` → Der umschlossene Text wird **2x eingerückt**.
+
+---
+
+## 2. Block-Formatierungen
+
+### Listen
+```text
+&-
+Erster Listenpunkt
+Zweiter Listenpunkt
+&
+