Gib ihnen das PDF, nicht das Markdown.

Ein Agent stellt ein Dokument fertig, du prüfst und überarbeitest es, und dann muss es auch jemand außerhalb der Technik lesen: eine Führungskraft, ein Kunde, jemand aus einem anderen Team. Diese Leute müssen nicht wissen, was ## oder eine Tabelle aus senkrechten Strichen bedeutet. Exportiere als PDF und gib ihnen stattdessen das.

Exportiere das geprüfte Dokument als PDF und schick diese Datei. Sie öffnet sich überall, braucht kein Markdown-Wissen und keine Installation und sieht so aus, wie du sie in der Vorschau gesehen hast, mit Diagrammen, Tabellen und Formatierung.

Warum nicht einfach die .md-Datei schicken

Eine rohe .md-Datei zeigt in einem einfachen Texteditor die Zeichen, nicht die Seite: # für eine Überschrift, ** um fetten Text, einen abgegrenzten Block für ein Mermaid-Diagramm, das nicht gezeichnet wird. Wer kein Markdown schreibt, liest nichts davon so, wie es gemeint ist, und zu verlangen, zuerst einen Viewer zu installieren, ist für ein einziges Dokument viel verlangt.

Warum kein Screenshot

Ein Screenshot friert einen Bildschirm voll eines Dokuments ein, das mehrere Seiten lang sein kann, lässt sich weder durchsuchen noch markieren und wird schlechter lesbar, wenn er ein paarmal komprimiert und weitergeleitet wurde. Ein PDF erhält Text, Diagramme und Seitenumbrüche, bei jeder Länge.

Was ein PDF dir bringt

Es öffnet sich in dem, was die Empfänger schon haben, Vorschau, ein Browser, Acrobat, ihr Telefon, ganz ohne Markdown-Werkzeug.
Mermaid-Diagramme sind gezeichnet, nicht als Code stehen gelassen; Codeblöcke behalten ihre Hervorhebung.
Seitenumbrüche sind so gewählt, dass keine Überschrift allein unten auf einer Seite landet und kein Diagramm auf zwei Seiten verteilt wird.
Dieselbe Datei, ob sie aus der MarsDawn-App kommt oder aus der kostenlosen Befehlszeile; die Anleitung dazu steht unter Markdown in PDF.

Weiter

Die Themen und Layouts, aus denen der Export kommen kann: Vorschauthemen und PDF-Export.
Aus einem Skript oder von einem Agenten exportieren statt aus der App: marsdawn für Agenten.
Warum ein Mensch das Dokument zuerst lesen muss: Warum Prüfen nötig ist.
Übergaben zwischen mehreren Agenten sind eine natürliche Quelle für PDFs zum Teilen: Vier Agenten-Entwurfsmuster und die Dokumente, die jedes dir übergibt.