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 +& +