JPKCom DB

Die Quarkdown-Reihe: Markdown mit Superkräften, in elf Teilen

Übersicht über meine elfteilige Quarkdown-Reihe — von der Einordnung über Skripting, Layout, Diagramme und wissenschaftliches Schreiben bis zu CLI, KI-Agent-Skill und Compiler-Pipeline.

von ·

Quarkdown ist eine Markdown-Obermenge mit Funktionen, Variablen und Skripting — ein „lesbares LaTeX", das aus einer Quelle eine Webseite, ein PDF, ein Buch oder eine Präsentation macht. Über elf Teile hinweg habe ich das Werkzeug von Grund auf durchgearbeitet: Funktionen und Einsatzgebiete, Tipps und Anwendungsbeispiele. Diese Seite ist der Einstieg und das Inhaltsverzeichnis der Reihe — von hier aus springst du in jeden Teil.

Warum Quarkdown

Markdown ist überall, stößt aber an eine Wand, sobald ein Dokument mehr will als Fließtext: Bildgrößen, nummerierte Abbildungen, mehrspaltiges Layout, wiederkehrende Bausteine, Mathematik. Quarkdown löst das mit einer einzigen Idee — dem Funktionsaufruf .func {…} — und bleibt dabei lesbar und maschinenfreundlich. Genau diese Doppelnatur (Klartext-Quelle, professionelles Artefakt) macht es zum spannenden Werkzeug für eine Welt, in der Menschen und KI-Systeme dieselben Inhalte lesen.

Die Reihe

  1. Wenn Markdown Textsatz lernt — Einordnung gegenüber Markdown, LaTeX und Typst, Grundidee, Installation, erstes Dokument.
  2. Funktionen, Variablen, Skripting — Funktionsaufrufe, Verkettung mit ::, Variablen, eigene Funktionen, Bedingungen, Schleifen, Mathe.
  3. Dokumenttypen, Themes & Seiten-Setup — wie .doctype aus einer Quelle vier Ausgaben macht, plus Themes und Seitenformat.
  4. Layout: Stacks, Container, Boxen & Grids — Inhalte anordnen, und warum die Leerzeile dabei entscheidet.
  5. Daten, Tabellen & Diagramme — Tabellen generieren, CSV einlesen, XY-Charts und Mermaid-Diagramme.
  6. Wissenschaftliches Schreiben — TeX-Formeln, Bibliografie, Cross-References, Nummerierung, Paper-Bibliothek.
  7. Präsentationen — Folien, interaktive Fragmente und Speaker-Notes auf reveal.js-Basis.
  8. CLI, PDF-Export & Deployment — die wichtigsten Optionen, Live-Preview, das Berechtigungssystem und CI/CD.
  9. Quarkdown & KI — das mitgelieferte Agent-Skill und warum Markdown die Brücke zur KI ist.
  10. Inside Quarkdown: die Pipeline — wie aus Quelltext in sechs Stufen HTML wird.
  11. Tipps & Tricks — die kleinen Kniffe, die den Alltag leichter machen.

Für wen sich das lohnt

Wer regelmäßig strukturierte Dokumente schreibt — Doku, Reports, Papers, Präsentationen, Wissensbasen — und dabei die Lesbarkeit von Markdown nicht gegen die Mächtigkeit von LaTeX eintauschen will, findet in Quarkdown einen Mittelweg. Die Teile 1 und 3 reichen für den Einstieg; die übrigen vertiefen einzelne Einsatzgebiete.

Weiterlesen

Die vollständige Referenz ist die offizielle Quarkdown-Wiki mitsamt der Standardbibliothek. Thematisch verwandt sind aus diesem Blog Was ist GEO? und Schreiben für KI — beide drehen sich, wie der KI-Teil dieser Reihe, um maschinenlesbare Inhalte.