Obsidian Design- und Markdown-Referenz – Spieler

Kurzreferenz für das Schreiben und Gestalten von Seiten im Ardania-Spieler-Vault und im veröffentlichten D&D Ardania Wiki.

Grundregel für Seitentitel

Der Dateiname ist bereits der sichtbare Seitentitel. Deshalb wird am Anfang einer Datei keine zusätzliche Überschrift mit # erstellt.

Die erste inhaltliche Überschrift beginnt normalerweise mit:

## Grunddaten

Überschriften werden hierarchisch verwendet:

## Hauptabschnitt
### Unterabschnitt
#### Detailabschnitt
##### Kleiner Detailpunkt
###### Tiefste Ebene

Nicht mehrere Ebenen überspringen. Nach ## sollte direkt ### folgen, nicht sofort ####.

Absätze und Zeilenumbrüche

Ein neuer Absatz entsteht durch eine Leerzeile:

Dies ist der erste Absatz.

Dies ist der zweite Absatz.

Ein einfacher Zeilenumbruch innerhalb desselben Absatzes kann mit zwei Leerzeichen am Zeilenende oder mit <br> erzeugt werden:

Erste Zeile.  
Zweite Zeile.

Erste Zeile.<br>
Zweite Zeile.

Textformatierung

Beispiel:

**Spezies:** Tiefling  
**Aktueller Wohnort:** [[Dragon_Gaze_Manor|Dragon Gaze Manor]]  
**Zustand:** *verwundet*

Listen

Ungeordnete Liste

- Ardania
- Aquaria
- Khaldor

Unterpunkte werden eingerückt:

- Ardania
  - Tharûn
  - Amun'Zhar

Nummerierte Liste

1. Auftrag erhalten
2. Reise vorbereiten
3. Ziel erreichen

Aufgabenliste

- [ ] Karte ansehen
- [ ] Ausrüstung ergänzen
- [x] Charakterbild eingefügt

Trennlinie

Eine horizontale Trennlinie wird mit drei Bindestrichen erstellt:

---

Sie eignet sich zwischen klar getrennten Themenblöcken.

Interne Wiki-Links

Link zu einer Seite

[[Ardania]]

Link mit anderem sichtbaren Text

[[Ardania|die Welt Ardania]]

Link zu einem Abschnitt

[[Ardania#Geografie]]

Link zu einem Abschnitt mit anderem Text

[[Ardania#Geografie|Geografie Ardanias]]

Link zu einem bestimmten Textblock

Ein Block erhält am Ende eine Kennung:

Dieser Satz kann direkt verlinkt werden. ^beispielblock

Link darauf:

[[Dateiname#^beispielblock]]

Noch nicht existierende Seite

[[Geplanter_Ort|Geplanter Ort]]

Der Link kann später durch Erstellen der Datei aufgelöst werden.

Externe Links

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

Beispiel:

[Offizielle D&D-Webseite](https://www.dndbeyond.com)

Für Inhalte innerhalb des Wikis möglichst TOKEN0 verwenden.

Bilder und Dateien

Bild einbetten

![[Ardalyn.jpg]]

Bildbreite festlegen

![[Ardalyn.jpg|700]]

Bild mit sichtbarer Alternativbezeichnung

![[Ardalyn.jpg|Königsstadt Ardalyn]]

Je nach Obsidian-Version kann für Bezeichnung und Breite folgende Form verwendet werden:

![[Ardalyn.jpg|Königsstadt Ardalyn|700]]

Bildformat und Design

• .jpg und .jpeg erhalten automatisch den gestalteten Rahmen.
• .png bleibt vollständig rahmenlos und transparent.
• Moodbilder, Landschaften und Karten können als JPEG gespeichert werden.
• Charakter-Artworks, Wappen, Logos und freigestellte Motive sollten als PNG gespeichert werden.

![[Moodbild_Ardalyn.jpg]]
![[NPC_Cruella.png]]

Andere Datei einbetten

![[Dokument.pdf]]

Ganze Obsidian-Seite einbetten

![[Ardania]]

Nur einen Abschnitt einbetten

![[Ardania#Geografie]]

Tabellen

Eine einfache Tabelle:

| Name | Art | Ort |
|---|---|---|
| Ardalyn | Hauptstadt | Ardania |
| Aetherwind | Handelsstadt | Ardania |

Spalten ausrichten

| Links | Zentriert | Rechts |
|:---|:---:|---:|
| Text | Text | Zahl |

• :--- = linksbündig
• :---: = zentriert
• ---: = rechtsbündig

Formatierung in Tabellen

| Feld | Inhalt |
|---|---|
| Name | **Cruella Valemorne** |
| Heimat | [[Dragon_Gaze_Manor|Dragon Gaze Manor]] |
| Zustand | *unverletzt* |

Für einen Zeilenumbruch innerhalb einer Tabellenzelle:

| Feld | Inhalt |
|---|---|
| Welten | Ardania<br>Aquaria<br>Khaldor |

Tabellen sollten kompakte Vergleichsdaten enthalten. Längere Lore-Texte bleiben besser in normalen Abschnitten.

Normales erzählerisches Zitat

Ein normales Markdown-Zitat erhält im Ardania-Design ein eigenes erzählerisches Kästchen:

> Drei Welten stehen. Ein Mond wandert. Zwei starren auf Ardania und hinterlassen ihre Schatten.

Mehrere Absätze innerhalb eines Zitats:

> Der erste Absatz des Zitats.
>
> Der zweite Absatz des Zitats.

Callout-Grundform

> [!note] Titel
> Inhalt des Callouts.

Ohne eigenen Titel verwendet Obsidian den Namen des Callout-Typs:

> [!warning]
> Dieser Bereich ist gefährlich.

Auf- und zuklappbare Callouts

Standardmässig geöffnet:

> [!note]+ Weitere Informationen
> Dieser Inhalt kann ein- und ausgeklappt werden.

Standardmässig geschlossen:

> [!note]- Weitere Informationen
> Dieser Inhalt ist zunächst eingeklappt.

Ardania-Quote- und Zitattypen

Hervorgehobenes Quote-Kästchen

Für markante Aussagen, Prophezeiungen oder zentrale gesprochene Texte:

> [!quote] Überlieferung
> Nicht das Licht bestimmt die Welt, sondern wo es fehlt.

Quellen- oder Überlieferungszitat

> [!zitat] Aus den Aufzeichnungen der Celestial Academy
> Die Beobachtung wurde während der dritten Maelor-Phase bestätigt.

Alternativ funktioniert:

> [!citation] Historische Quelle
> Der ursprüngliche Wortlaut ist nur fragmentarisch erhalten.

Weitere nützliche Standard-Callouts

> [!note] Notiz
> Allgemeine Zusatzinformation.

> [!info] Information
> Sachliche Hintergrundinformation.

> [!tip] Hinweis
> Praktische Anwendung oder Empfehlung.

> [!warning] Warnung
> Mögliche Gefahr oder problematischer Punkt.

> [!danger] Gefahr
> Akute oder besonders schwere Bedrohung.

> [!question] Frage
> Eine bewusst offen formulierte Frage.

> [!example] Beispiel
> Ein konkretes Anwendungsbeispiel.

> [!success] Erfolg
> Erfolgreich abgeschlossener Schritt.

> [!failure] Fehlschlag
> Gescheiterter oder verworfener Ansatz.

> [!bug] Fehler
> Technischer oder inhaltlicher Fehler.

> [!todo] Aufgabe
> Noch auszuführende Arbeit.

Codeblöcke

Ein allgemeiner Codeblock:

````md

Dieser Text wird unverändert in einem Codeblock dargestellt.

````

Mit Sprachangabe für Syntaxhervorhebung:

````md

<p>Beispieltext</p>

````

Für Markdown-Beispiele auf Referenzseiten:

````md

**Fett**
[[Wiki-Link]]

````

Fussnoten

Fussnote im Text:

Die älteste Überlieferung nennt einen anderen Namen.[^1]

Definition der Fussnote:

[^1]: Quelle oder ergänzende Erklärung.

Benannte Fussnoten sind ebenfalls möglich:

Diese Erzählung besitzt mehrere Fassungen.[^quelle]

[^quelle]: Überlieferung aus der Bibliothek von Ardalyn.

Tags

Ein Tag wird mit # geschrieben:

#NPC
#Fraktion
#Ort

Verschachtelte Tags:

#NPC/Ardania
#Kampagne/Masketiers

Tags nicht mit Überschriften verwechseln: Eine Überschrift besitzt nach dem # ein Leerzeichen, ein Tag nicht.

## Überschrift
#Tag

Sonderzeichen anzeigen

Wenn ein Markdown-Zeichen sichtbar bleiben soll, wird ein Backslash davor gesetzt:

\*Dieser Text wird nicht kursiv.\*
\# Dies ist keine Überschrift.
\> Dies ist kein Zitat.

Empfohlene Seitenstruktur

Kurze Einleitung oder Zusammenfassung.

## Grunddaten

**Art:**  
**Ort:**  
**Zugehörigkeit:**  

## Beschreibung

Fliesstext.

## Wichtige Punkte

- Punkt eins
- Punkt zwei

## Überlieferung

> [!quote] Bekannte Worte
> Ein hervorgehobenes Zitat.

## Quelle

> [!zitat] Historische Aufzeichnung
> Ein Quellen- oder Überlieferungszitat.

Keine YAML-Properties, keine zusätzliche Titelüberschrift und keine abschliessende Verbindungssektion verwenden.

Quelle im öffentlichen Player Vault: 99_Hilfe/Obsidian_Design-_und_Markdown-Referenz_-_Spieler