# 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: ```md ## Grunddaten ``` Überschriften werden hierarchisch verwendet: ```md ## 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**: ```md 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: ```md Erste Zeile. Zweite Zeile. ``` ```md Erste Zeile.<br> Zweite Zeile. ``` --- ## Textformatierung | Darstellung | Markdown | Verwendung | |---|---|---| | **Fett** | `**Fett**` | Namen, Schlüsselbegriffe, Feldbezeichnungen | | *Kursiv* | `*Kursiv*` | Betonung, Gedanken, fremdsprachige Begriffe | | ***Fett und kursiv*** | `***Fett und kursiv***` | sehr starke Hervorhebung | | ~~Durchgestrichen~~ | `~~Durchgestrichen~~` | ersetzte oder ungültige Angaben | | ==Markiert== | `==Markiert==` | besonders wichtige Stellen | | `Inline Code` | `` `Inline Code` `` | Dateinamen oder technische Begriffe | Beispiel: ```md **Spezies:** Tiefling **Aktueller Wohnort:** [[Dragon_Gaze_Manor|Dragon Gaze Manor]] **Zustand:** *verwundet* ``` --- ## Listen ### Ungeordnete Liste ```md - Ardania - Aquaria - Khaldor ``` Unterpunkte werden eingerückt: ```md - Ardania - Tharûn - Amun'Zhar ``` ### Nummerierte Liste ```md 1. Auftrag erhalten 2. Reise vorbereiten 3. Ziel erreichen ``` ### Aufgabenliste ```md - [ ] Karte ansehen - [ ] Ausrüstung ergänzen - [x] Charakterbild eingefügt ``` --- ## Trennlinie Eine horizontale Trennlinie wird mit drei Bindestrichen erstellt: ```md --- ``` Sie eignet sich zwischen klar getrennten Themenblöcken. --- ## Interne Wiki-Links ### Link zu einer Seite ```md [[Ardania]] ``` ### Link mit anderem sichtbaren Text ```md [[Ardania|die Welt Ardania]] ``` ### Link zu einem Abschnitt ```md [[Ardania#Geografie]] ``` ### Link zu einem Abschnitt mit anderem Text ```md [[Ardania#Geografie|Geografie Ardanias]] ``` ### Link zu einem bestimmten Textblock Ein Block erhält am Ende eine Kennung: ```md Dieser Satz kann direkt verlinkt werden. ^beispielblock ``` Link darauf: ```md [[Dateiname#^beispielblock]] ``` ### Noch nicht existierende Seite ```md [[Geplanter_Ort|Geplanter Ort]] ``` Der Link kann später durch Erstellen der Datei aufgelöst werden. --- ## Externe Links ```md [Angezeigter Linktext](https://example.com) ``` Beispiel: ```md [Offizielle D&D-Webseite](https://www.dndbeyond.com) ``` Für Inhalte innerhalb des Wikis möglichst `[[Wiki-Links]]` verwenden. --- ## Bilder und Dateien ### Bild einbetten ```md ![[Ardalyn.jpg]] ``` ### Bildbreite festlegen ```md ![[Ardalyn.jpg|700]] ``` ### Bild mit sichtbarer Alternativbezeichnung ```md ![[Ardalyn.jpg|Königsstadt Ardalyn]] ``` Je nach Obsidian-Version kann für Bezeichnung und Breite folgende Form verwendet werden: ```md ![[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. ```md ![[Moodbild_Ardalyn.jpg]] ![[NPC_Cruella.png]] ``` ### Andere Datei einbetten ```md ![[Dokument.pdf]] ``` ### Ganze Obsidian-Seite einbetten ```md ![[Ardania]] ``` ### Nur einen Abschnitt einbetten ```md ![[Ardania#Geografie]] ``` --- ## Tabellen Eine einfache Tabelle: ```md | Name | Art | Ort | |---|---|---| | Ardalyn | Hauptstadt | Ardania | | Aetherwind | Handelsstadt | Ardania | ``` ### Spalten ausrichten ```md | Links | Zentriert | Rechts | |:---|:---:|---:| | Text | Text | Zahl | ``` - `:---` = linksbündig - `:---:` = zentriert - `---:` = rechtsbündig ### Formatierung in Tabellen ```md | Feld | Inhalt | |---|---| | Name | **Cruella Valemorne** | | Heimat | [[Dragon_Gaze_Manor|Dragon Gaze Manor]] | | Zustand | *unverletzt* | ``` Für einen Zeilenumbruch innerhalb einer Tabellenzelle: ```md | 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: ```md > Drei Welten stehen. Ein Mond wandert. Zwei starren auf Ardania und hinterlassen ihre Schatten. ``` Mehrere Absätze innerhalb eines Zitats: ```md > Der erste Absatz des Zitats. > > Der zweite Absatz des Zitats. ``` --- ## Callout-Grundform ```md > [!note] Titel > Inhalt des Callouts. ``` Ohne eigenen Titel verwendet Obsidian den Namen des Callout-Typs: ```md > [!warning] > Dieser Bereich ist gefährlich. ``` ### Auf- und zuklappbare Callouts Standardmässig geöffnet: ```md > [!note]+ Weitere Informationen > Dieser Inhalt kann ein- und ausgeklappt werden. ``` Standardmässig geschlossen: ```md > [!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: ```md > [!quote] Überlieferung > Nicht das Licht bestimmt die Welt, sondern wo es fehlt. ``` ### Quellen- oder Überlieferungszitat ```md > [!zitat] Aus den Aufzeichnungen der Celestial Academy > Die Beobachtung wurde während der dritten Maelor-Phase bestätigt. ``` Alternativ funktioniert: ```md > [!citation] Historische Quelle > Der ursprüngliche Wortlaut ist nur fragmentarisch erhalten. ``` --- ## Weitere nützliche Standard-Callouts ```md > [!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 ```text Dieser Text wird unverändert in einem Codeblock dargestellt. ``` ```` Mit Sprachangabe für Syntaxhervorhebung: ````md ```html <p>Beispieltext</p> ``` ```` Für Markdown-Beispiele auf Referenzseiten: ````md ```md **Fett** [[Wiki-Link]] ``` ```` --- ## Fussnoten Fussnote im Text: ```md Die älteste Überlieferung nennt einen anderen Namen.[^1] ``` Definition der Fussnote: ```md [^1]: Quelle oder ergänzende Erklärung. ``` Benannte Fussnoten sind ebenfalls möglich: ```md Diese Erzählung besitzt mehrere Fassungen.[^quelle] ``` ```md [^quelle]: Überlieferung aus der Bibliothek von Ardalyn. ``` --- ## Tags Ein Tag wird mit `#` geschrieben: ```md #NPC #Fraktion #Ort ``` Verschachtelte Tags: ```md #NPC/Ardania #Kampagne/Masketiers ``` Tags nicht mit Überschriften verwechseln: Eine Überschrift besitzt nach dem `#` ein Leerzeichen, ein Tag nicht. ```md ## Überschrift #Tag ``` --- ## Sonderzeichen anzeigen Wenn ein Markdown-Zeichen sichtbar bleiben soll, wird ein Backslash davor gesetzt: ```md \*Dieser Text wird nicht kursiv.\* \# Dies ist keine Überschrift. \> Dies ist kein Zitat. ``` --- ## Empfohlene Seitenstruktur ```md 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.