Markdown-Grundlagen

Markdown ist die zugrunde liegende Schreibsprache von Obsidian.

Markdown verwendet Klartextsymbole, um Formatierungen auszudrücken, sodass du beim Schreiben die Hände auf der Tastatur lassen und dich auf den Inhalt statt auf das Layout konzentrieren kannst.

Dieses Kapitel behandelt die am häufigsten verwendete Markdown-Syntax im täglichen Gebrauch von Obsidian. Alle Beispiele können direkt in Obsidian geübt werden.

Weitere Markdown-Inhalte findest du unter:https://www.example.com/markdown/md-tutorial.html

Überschriften

Markdown verwendet#das `#`-Zeichen, um Überschriften zu kennzeichnen, wobei die Zahlen von 1 bis 6 H1 bis H6 entsprechen.

In Obsidian haben Überschriften zwei zusätzliche Funktionen: Das Outline-Panel erstellt automatisch eine Dokumentgliederung basierend auf Überschriften, und andere Notizen können[[Notizname#Überschrift]]verwenden, um direkt auf eine bestimmte Überschrift zu verlinken.

Es wird empfohlen, im Haupttext mit Überschriften der Ebene 2 zu beginnen und Überschriften der Ebene 1 dem Haupttitel der Notiz vorzubehalten. Dadurch wird die Gliederungsstruktur klarer und es ist später leichter, Inhalte über Überschriftenverweise zu finden.

Textformatierung

Für grundlegende Inline-Stile umschließen Sie den Text einfach mit den folgenden Symbolen.

Gerendertes Ergebnis:

• Fett:Dies ist fett
• Kursiv:Dies ist kursiv
• Fett-kursiv:Dies ist fett und kursiv
• Durchgestrichen:Dies ist durchgestrichen
• Hervorhebung:Dies ist hervorgehoben

Darunter==Highlight==ist eine Erweiterung von Standard-Markdown durch Obsidian und funktioniert möglicherweise nicht in regulären Markdown-Editoren.

Blockzitate

Verwende>das `>`-Symbol, um Blockzitate zu erstellen, geeignet zum Zitieren externer Quellen oder zum Hervorheben wichtiger Inhalte.

In Obsidian haben Blockzitate eine weitere besondere Verwendung: Fügen Sie ein Label vor dem Zitat hinzu[!note]Mit dieser Art von Label kann das Blockzitat zu einer Callout-Box werden.

Listen und Aufgabenlisten

Ungeordnete Liste

Verwenden Sie-、*oder+das `-`-Symbol, um eine ungeordnete Liste zu erstellen.

Unterlisten verwenden Einrückung (Tab oder zwei Leerzeichen), um Ebenen anzugeben.

Geordnete Liste

Verwende eine Zahl gefolgt von.einem Punkt, um eine geordnete Liste zu erstellen. Die Zahlen selbst müssen nicht fortlaufend sein; Markdown nummeriert automatisch weiter.

Aufgabenliste

Verwende- [ ]Erzeugt anklickbare Kontrollkästchen; dies ist eine der am häufigsten verwendeten Syntaxen in Obsidian.

Klicke in Obsidian auf das Kontrollkästchen, um seinen Erledigungsstatus umzuschalten.

Mit dem Dataview-Plugin kannst du außerdem alle unerledigten Aufgaben notizübergreifend zusammenfassen — diese fortgeschrittene Verwendung wird in späteren Kapiteln behandelt.

Code und Codeblöcke

Inline-Code

Verwende einen einzelnen Backtick`, um Inline-Code oder Befehle einzuschließen.

Codeblöcke

Verwende drei Backticks```, um mehrzeiligen Code einzuschließen, und gib die Sprache am Anfang an, um Syntaxhervorhebung zu erhalten.

Obsidian unterstützt Syntaxhervorhebung für Dutzende Programmiersprachen, einschließlich Python, JavaScript, C++, Java, Go, Rust, SQL, Bash und mehr.

Tabellen

Verwende `|`|, um Spalten zu trennen, und verwende---`-`, um die Kopfzeile vom Tabellenkörper zu trennen.

In---In Zeilen verwenden Sie:`:` zur Steuerung der Ausrichtung.

Ausrichtungsregeln:

• ---Standardmäßig linksbündig
• :---:Zentriert
• ---:Rechtsbündig

Markdown-Tabellen unterstützen das Zusammenführen von Zellen nicht. Wenn Sie komplexe Tabellen benötigen, ziehen Sie HTML<table>`<table>`-Tag in Betracht; Obsidian unterstützt das direkte Einbetten von HTML in Markdown-Dateien.

Bilder und Links

Hyperlinks

Die grundlegende Syntax ist[Anzeigetext](URL)。

Images

Die Syntax ähnelt der von Links; füge einfach `!` davor ein.!。

Obsidian unterstützt das direkte Einfügen von Bildern; es kopiert das Bild automatisch in den Anhängeordner und fügt einen Verweis in die aktuelle Notiz ein.

Obsidian erweitert die Bildsyntax; du kannst nach dem Dateinamen|widthhinzufügen, um die Anzeigegröße zu steuern, zum Beispiel begrenztdie Bildbreite auf 400 Pixel.

Obsidian-exklusiv: Interne Links

Zusätzlich zu Standard-Markdown-Links bietet Obsidian die Syntax[[Note name]], um auf andere Notizen im Vault zu verlinken.

Dies ist die grundlegendste Syntax von Obsidian, und das nächste Kapitel wird sie ausführlich erläutern.

Horizontale Linie

Verwende drei oder mehr---、***oder___, um eine horizontale Linie zu erstellen.

Beachte den Unterschied:---Eine einzelne Zeile ist eine horizontale Linie, aber ganz oben im Dokument,---ist der Inhalt zwischen den Markierungen YAML Front Matter (siehe den nächsten Abschnitt). Obsidian erkennt den Kontext automatisch, um zu entscheiden, ob es sich um eine horizontale Linie oder Front Matter handelt.

YAML Front Matter

Front Matter ist ein Metadatenblock, der ganz oben in einer Notiz steht und von zwei Sätzen von---Markierungen umschlossen wird.

Es wird verwendet, um die Eigenschaften der Notiz zu definieren: Tags, Aliase, Erstellungsdatum, Status usw.

Übliche Beschreibungen der Front-Matter-Felder:

Feldnamen in Front Matter sind case-sensitive. Es wird empfohlen, Namenskonventionen innerhalb eines Teams oder Projekts zu standardisieren, umtagsundTagsinkonsistente Verwendung zu vermeiden, die dazu führt, dass Dataview-Abfragen Daten verfehlen.

Der Kernwert von Front Matter liegt in der Verwendung mit dem Dataview-Plugin — du kannst alle Notizen mit dem Tag "obsidian" und dem Status "In Progress" herausfiltern, genau wie beim Abfragen einer Datenbank.

Markdown-Syntax-Spickzettel