Markdown (CommonMark) in unserem Wiki verwenden

Hinweis: Dieses Dokument ist eine automatische Übersetzung des englischen Originals.

Diese Seite ist ein kurzer „Spickzettel“ für die Formatierung von Seiten in unserem Wiki, in dem Inhalte in CommonMark Markdown verfasst werden.

Grundregeln

• Schreiben Sie in einfachen, kurzen Sätzen.
• Machen Sie die Seite schnell erfassbar: Überschriften + Listen + Tabellen.
• Ein Abschnitt = eine Idee. Vermeiden Sie „Textwände“.

Überschriften

Verwenden Sie ## / ### / #### für die Struktur.

## Abschnitt
### Unterabschnitt
#### Unter-Unterabschnitt

Fett, kursiv, Inline-Code

**fett**
*kursiv*
`Code/Feld/Adresse`

Links

[Linktext](https://example.com)

Wenn Sie einen „nackten“ Link anzeigen müssen (selten):

`https://example.com`

Listen

Aufzählungsliste:

- Element 1
- Element 2
  - Unterelement

Nummerierte Liste:

1. Schritt 1
2. Schritt 2
3. Schritt 3

Zitate / Hinweise

> Dies ist ein wichtiger Hinweis.
> Er kann aus zwei Zeilen bestehen.

Tabellen

Minimale Vorlage:

| Feld | Wert |
|---|---|
| Name | [ ] |
| Status | [ ] |

Tipps:

• Die Trennzeile |---|---| ist erforderlich.
• Tabellenzellen können **fett**, Links und Code enthalten.

Code- und „Roh“-Textblöcke

Codeblock:

\```text
Zeile 1
Zeile 2
\```

Wenn es sich um eine bestimmte Sprache handelt (z. B. JSON), können Sie diese angeben:

\```json
{ "key": "value" }
\```

Bilder

Wenn Sie eine direkte Bild-URL haben:

![Beschreibung](https://example.com/image.png)

Wenn die Datei in das Wiki hochgeladen wird, verwenden Sie den Link/die Einbettung, die das Wiki beim Hochladen bereitstellt.

Zeilenumbrüche und Absätze

• Ein neuer Absatz ist eine Leerzeile zwischen den Absätzen.
• Wenn Sie einen Zeilenumbruch innerhalb eines Absatzes benötigen, fügen Sie am Ende der Zeile zwei Leerzeichen hinzu:

Erste Zeile.  
Zweite Zeile.

Eingebettetes HTML (mit Vorsicht verwenden)

Einklappbarer „Details“-Block

Verwenden Sie diesen für lange Details/Beweise, um eine Überladung des „ersten Bildschirms“ zu vermeiden.

<details>
<summary><b>Details</b></summary>

Hier können Sie Text, Listen und Tabellen platzieren.

</details>

Anker und Schnelllinks innerhalb einer Seite

Anker:

<a id="ai-thesis-fit"></a>

Link zum Anker:

[Zum Abschnitt KI-Thesen-Passung springen](#ai-thesis-fit)

Platzhalter in Vorlagen

In Vorlagen verwenden wir:

• [ ] — „ausfüllen“
• — / — — „— / nicht zutreffend“ (wenn sinnvoll)
• YYYY‑MM‑DD — Datumsformat
• Tier‑1/2/3 — Quellenniveau (Beweis/Kontext/Rauschen)

Häufige Fehler

• Mischen von Infobox und Beschreibung: Die Infobox ist nur für kurze Fakten gedacht; Erklärungen gehören in den Seitentext.
• Schreiben ohne Quellen, wo eine Quelle existieren sollte.
• Überladen des „ersten Bildschirms“: Lange Details sind in <details> besser aufgehoben.
• Verwendung von „Finanzsprache“ (Kauf-/Verkauf-/Halteempfehlungen, Prognosen) — das ist für uns verboten; wir schreiben Fakten/Risiken/was zu überprüfen ist.

Mini-Checkliste vor der Veröffentlichung

• Gibt es 1–2 Zeilen, die erklären, „was es ist“?
• Gibt es Links zu Primärquellen?
• Gibt es leere „unklare“ Tabellenfelder (jedes Feld ist entweder ein Wert oder —/—)?
• Ist Last verified ausgefüllt?