update

templates/Format/Baustein.md

@@ -83,6 +83,32 @@ CODE-BEISPIEL
 - Mit kurzem Label oben (2-4 Wörter)
 - Syntax-Highlighting durch span-Klassen (.k, .v, .s, etc.)
 
+HTML-ENTITIES IM CODE (PFLICHT bei HTML/XML/JSX/Vue/JSX-ähnlichem Code)
+- Wenn das Code-Beispiel SELBST HTML, XML, JSX oder ähnliche Tag-Syntax zeigt, MÜSSEN spitze Klammern als HTML-Entities geschrieben werden:
+  - `<` → `&lt;`
+  - `>` → `&gt;`
+  - `&` → `&amp;`
+- Grund: der Code wird via v-html im Browser gerendert. Rohe `<h1>` werden sonst als echtes DOM-Element interpretiert und verschwinden.
+- Gut: `<span class="t">&lt;h1&gt;</span>Text<span class="t">&lt;/h1&gt;</span>`
+- Schlecht: `<span class="t"><h1></span>Text<span class="t"></h1></span>`
+- Schlecht: `<h1>Text</h1>` (komplett ohne Spans und ohne Entities)
+- Diese Regel gilt NUR für die Inhalte des Code-Beispiels, NICHT für die `<span class="...">`-Wrapper selbst
+
+KONKRETES BEISPIEL — Baustein "Header" (HTML)
+```json
+{
+  "title": "Header",
+  "description": "Definiert eine Überschrift.",
+  "purpose": "Strukturiert die Seiteninhalte.",
+  "examples": [
+    {
+      "label": "Alle Header",
+      "code": "<span class=\"t\">&lt;h1&gt;</span>Hauptüberschrift<span class=\"t\">&lt;/h1&gt;</span>\n<span class=\"t\">&lt;h2&gt;</span>Kapitel<span class=\"t\">&lt;/h2&gt;</span>\n<span class=\"t\">&lt;h3&gt;</span>Unterabschnitt<span class=\"t\">&lt;/h3&gt;</span>"
+    }
+  ]
+}
+```
+
 VERMEIDEN
 - Lange Erklärungstexte
 - Mehrere Sätze für Beschreibung oder Zweck
@@ -111,6 +137,7 @@ GENERIERUNG MIT FEEDBACK-LOOP
    - Label über Code-Block kurz und prägnant?
    - Card kompakt, kein leerer Raum?
    - Ist das gewählte Beispiel wirklich das typischste?
+   - Bei HTML/XML/JSX-Code: alle `<` und `>` als `&lt;` und `&gt;` geschrieben?
 4. Wenn etwas zu viel: weglassen, nicht hinzufügen
 5. Bei jeder Iteration prüfen: lässt sich noch was weglassen?
 ```