SimonUp/readme.md

SimonUp statt Markdown 😉

Mein Enwurf für eine schreibfreundlichere Sprache.

Syntax

Textformatierung

#Text# → Titel H1
##Text## → Titel H2
*Text* → Fett
_Text_ → Unterstrichen
/Text/ → Kursiv
~Text~ → Durchgestrichen
^Text^ → Hochgestellt
^^Text^^ → Tiefgestellt
\Zeichen → Escape (z. B. \# → #)
|Text| → Zentriert
>Text> → Einrücken
>>Text>> → 2x Einrücken

Listen

-Text- → Liste
+Text+ → Nummerierte Liste

Links

[Text](URL) → Link
[Text]{URL} → Link new Tab

Code

`Text` → Code

Bilder

![Alt-Text](URL) → Bild mit Alt-Text
![Alt-Text w:200 h:150](URL) → Bild mit Alt-Text und Grösse definiert
![Alt-Text left/right/center](URL) → Positioniert
![Alt-Text left33%](URL) → Ausrichtung links, 33% der Seitenbreite
![Alt-Text](URL) |Unterschrift| → Bild mit Bildunterschrift

Fussnoten

^1[Text]^ → Fussnote manuelle Nummer + Text
^x[Text]^ → Fussnote automatische Nummer + Text

Textblöcke

>[c] Text> → Codeblock
>[c Sprache] Text> → Codeblock
>[q] Text> → Zitatblock
>[b] Text> → Bibel-Textblock

SimonUp Syntax-Spezifikation

SimonUp 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

SimonUp 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*	Medium	Halbfette Betonung (font-weight: 500).
**Text**	Fett	Starke, fette Betonung (font-weight: 700) / 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

&-
Erster Listenpunkt
Zweiter Listenpunkt
&

### Textblöcke (Code, Zitate, Bibelstellen)
```text
&c python
def simonup():
    print("Fluss-Formatierungen werden hier ignoriert.")
&

---

# SimonUp Syntax-Spezifikation

SimonUp ist eine moderne, fluss- und blockorientierte Auszeichnungssprache (Dateiendung: `.up`). Sie wurde entwickelt, um den Schreibfluss zu maximieren, die Finger-Akrobatik auf der Tastatur zu minimieren und die Schwachstellen von traditionellem Markdown elegant zu lösen.

---

## Philosophie: Fluss vs. Block

SimonUp trennt strikt zwischen zwei Logiken:
1. **Fluss-Formatierungen (Inline):** Werden mit *einem* einzelnen Zeichen (oder einer Verdopplung) geöffnet und geschlossen. Sie erlauben Formatierungen mitten im Satz, ohne eine neue Zeile zu erzwingen, und funktionieren auch innerhalb von Blöcken.
2. **Block-Formatierungen (Strukturell):** Beginnen *immer* am Zeilenanfang mit `&` plus einem Typ-Kürzel und 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*` | **Medium** | Halbfette Betonung (`font-weight: 500`). |
| `**Text**` | **Fett (Bold)** | Starke Betonung (`font-weight: 700`) / Tabellenkopf. |
| `/Text/` | *Kursiv* | Leichte Betonung / Zitate im Text. |
| `_Text_` | <u>Unterstrichen</u> | Sauberer, dokumentenähnlicher Textstil. |
| `~Text~` | ~~Durchgestrichen~~ | Korrekturen oder erledigte To-Dos. |
| `=Text=` | <mark>Highlight</mark> | Textmarker-Effekt für wichtige Schlüsselwörter. |
| `^Text^` | <sup>Hochgestellt</sup> | Mathematische Notation oder Indizes. |
| `°Text°` | <sub>Tiefgestellt</sub> | Chemische Formeln (liegt auf derselben Taste wie `^`!). |
| `` `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 & Strukturen (`&-`, `&+`)
```text
&-
Erster Listenpunkt
Zweiter Listenpunkt
&

Ergebnis: Unsortierte Aufzählung (Bullet Points).

&+
Erster nummerierter Punkt
Zweiter nummerierter Punkt
&

Ergebnis: Nummerierte Liste (1., 2., ...).

Kompakte Block-Übersicht (&c, &q, &b, &f)

Block-Typ	Kurzbeschreibung & Syntax-Beispiel
Code (&c)	&c python

print("Fluss-Formatierungen werden hier ignoriert")

& | | Zitat (&q) | &q

„Dies ist ein eigenständiger Zitatblock (Blockquote).“

& | | Bibeltext (&b) | &b

„Ein spezialisierter Textblock für Bibelstellen und Quelltexte.“

& | | Spoiler / Fold (&f) | &f Klickbarer Titel des Spoilers

Hier steht der standardmäßig versteckte Inhalt (HTML <details>).

& |

Tabellen & Galerien (&t)

Tabellen definieren ihre Spaltenanzahl (3x = 3 gleiche Spalten) oder manuelle Breiten (20% 80%) in der Startzeile. Die erste Zeile wird durch `` automatisch als Tabellenkopf deklariert.

&t 3x
**Name** | **Beruf** | **Stadt**
Simon | Entwickler | Zürich
&

---

3. Links, Medien & Fußnoten

Links & Medien

• [Codeberg](URL) → Standard-Link (selber Tab)
• [Codeberg]{URL} → Komfort-Link (neuer Tab / target="_blank")
• ![Alt-Text](URL) → Standard-Bild
• ![Alt-Text w:300](URL) → Bild mit definierter Breite (Höhe skaliert automatisch)

Bildergalerien (Kombination aus &t und ![...])

&t 3x
![Alpen](berge.jpg) | ![Italien](strand.jpg) | ![Schwarzwald](wald.jpg)
|Abbildung 1: Alpen| |Abbildung 2: Italien| |Abbildung 3: Schwarzwald|
&

Fußnoten

• ^1[Hier steht der Fußnotentext]^ → Manuelle Nummerierung (Fußnote 1)
• ^x[Hier steht der Fußnotentext]^ → Automatische, fortlaufende Nummerierung durch SimonUp