Deutsch
Über dieses Handbuch

Dieses Handbuch gehört zur Vorlage Example für QuartzControl. Es erklärt die Vorlage und führt zugleich alles vor, was sie kann.

Der Text hier kommt aus einer Markdown-Datei, nicht aus der Konfiguration.

2 – Formatierung

Notizen in Obsidian sind Markdown: Text mit ein paar Zeichen darin, die Bedeutung tragen — zwei Sternchen für fett, eine Raute für eine Überschrift, eckige Klammern für einen Link. Quartz liest diese Zeichen und macht daraus die Seite. Dieses Kapitel zeigt jedes Element, das man so schreiben kann, auf einer eigenen kurzen Seite: zuerst der Quelltext in einem Codeblock, direkt darunter, was die Website daraus macht.

Zum Abschreiben

Der Kasten oben auf jeder Seite ist genau das, was man in Obsidian tippt. Wer ein Element nachbauen will, kopiert ihn — und vergleicht sein Ergebnis mit dem darunter.

Die dreizehn Abschnitte

AbschnittWas darin steht
2.1 – Textfett, kursiv, durchgestrichen, hervorgehoben, Sonderzeichen, Zeilenumbrüche
2.2 – StrukturÜberschriften, Absätze, Trennlinien
2.3 – Listenungeordnet, geordnet, Aufgaben, Verschachtelung
2.4 – LinksWikilinks, Sprungziele, externe Links, Aliase, Einbettungen
2.5 – Calloutsalle dreizehn Typen, faltbar, verschachtelt
2.6 – Codeinline, Blöcke, Sprachen, Zeilenhervorhebung
2.7 – TabellenGrundform, Ausrichtung, Inhalte, breite Tabellen
2.8 – MathematikFormeln inline und als Block
2.9 – DiagrammeMermaid: vierzehn Diagrammarten auf sechs Seiten
2.10 – FußnotenFußnoten, Varianten, Kommentare
2.11 – EigenschaftenFrontmatter, Datentypen, Anzeige
2.12 – MedienBilder, Größen, Video, Audio, Dokumente, Einbettungen
2.13 – BesonderesHTML, Escapes, Pfeile, Emoji

Was keine Markdown-Seite ist — Bases, Canvas und Excalidraw — steht in 3 – Obsidian-Formate. Was das Frontmatter einer Seite bewirkt — Entwurf, Datum, Alias, Titelbild —, steht in 4 – Eine Seite steuern.

Was Obsidian kann und Quartz nicht

Obsidian und Quartz sprechen fast dieselbe Sprache, aber nicht ganz. Diese Abweichungen sind an der gebauten Website gemessen; die verlinkte Seite zeigt jeweils, was stattdessen geht.

In ObsidianAuf der WebsiteWo es steht
Aufgaben mit Zwischenzuständen ([/], [-], [?])nur offen und erledigt; jedes andere Zeichen wird ein leeres KästchenAufgaben
Inline-Fußnote ^[Text]bleibt als Rohtext stehenVarianten
Pfeile wie --> werden zu →bleiben Rohtext; mit GitHub flavored markdown wird —> darausPfeile und Emoji
Ein Tag im Fließtextder Link daran führt aus der Website heraus — ein Fehler in QuartzPfeile und Emoji
Bild mit Größe und Alternativtextnur eines von beidenBilder
Eingebettetes PDF ab Seite 2beginnt immer auf Seite 1Dokumente
Definitionslistengibt es in beiden nicht, HTML hilft ausHTML

Dazu kommt, was auf dieser Website absichtlich anders aussieht als in Quartz von Haus aus — die Callout-Farben etwa. Das steht nicht hier, sondern in 5 – Die Gestaltung bei der jeweiligen Komponente.

Weiterlesen

Diese Seite gehört zu Example — der Beispielvorlage für QuartzControl. Ein Überblick über alle Bereiche steht auf der Startseite.

Auf einem schmalen Bildschirm ist die Navigation oben eingeklappt.