Drei Wege, marsdawn aufzurufen.

MarsDawn hat kein eigenes KI-Modell: Es ist gebaut, um Markdown zu prüfen, nicht um es zu schreiben, daher ist egal, welcher Agent oder welches Modell die Datei erzeugt hat. Es gibt drei Wege, wie ein Agent oder ein Skript marsdawn aufrufen kann, und alle drei führen am Ende dasselbe export aus.

Nimm, was deine Werkzeuge unterstützen: die kostenlose marsdawn-CLI, eine Skill-Datei in reinem Markdown oder den MCP-Server marsdawn-mcp. Alle drei rufen dasselbe marsdawn export auf und liefern dasselbe JSON-Ergebnis.

Welchen Weg nehmen

Wenn dein Agent	Nimm	Braucht
Einen Shell-Befehl ausführen kann	Die CLI	macOS 15 oder neuer
Anweisungsdateien lädt, wie Claude Code	Die Skill-Datei	Die CLI, die der Skill installiert
Werkzeuge über MCP aufruft	marsdawn-mcp	marsdawn-mcp 0.2.1 oder neuer, marsdawn 0.5.0 oder neuer und Node.js 20 oder neuer

Die CLI

marsdawn export notes.md --json kann jeder Agent und jedes Skript aufrufen, das einen Shell-Befehl ausführen kann, und ist damit von Haus aus modellunabhängig. Jedes Feld, das es liefert, ist unter marsdawn für Agenten dokumentiert. Das ist die maßgebliche Quelle für das JSON-Schema, auf die die beiden anderen Wege unten verweisen.

Die Skill-Datei

Für einen Agenten, der Anweisungen in reinem Markdown liest, statt direkt eine Shell aufzurufen (heute Claude Code), ist der marsdawn-Skill eine Datei, die ihm beibringt, marsdawn zu installieren, export auszuführen und das Ergebnis zu lesen. Sie ist reines Markdown, also können andere Agenten, die Anweisungsdateien laden, dieselbe verwenden.

Der MCP-Server

marsdawn-mcp ist ein eigenes, öffentliches Repository unter Apache-2.0. Es ist ein MCP-Server mit zwei Werkzeugen, export_markdown_to_pdf und open_in_marsdawn, die marsdawn export --json und marsdawn open --json umschließen: Richte einen MCP-Client darauf, und ein Werkzeugaufruf liefert dasselbe JSON wie die CLI.

Bezugsquelle: als MCP Bundle, marsdawn.mcpb, angehängt an sein GitHub-Release, oder indem du den Server aus dem Quellcode über stdio startest.
Registry: in der MCP Registry als dev.southern-light.mcp/marsdawn gelistet.
Hosting: nur selbst gehostet. Es gibt keinen gehosteten marsdawn-mcp-Dienst; der Server läuft auf deinem eigenen Rechner, neben marsdawn selbst.
Voraussetzungen: macOS, marsdawn 0.5.0 oder neuer und Node.js 20 oder neuer, um den Server auszuführen.

Auf Ordner beschränkt, die du erlaubst

Beide Werkzeuge greifen nur auf Ordner zu, die du erlaubst: die Einstellung Allowed folders der Erweiterung, die leer und ohne Voreinstellung beginnt, oder stattdessen die Roots, die dein MCP-Client anbietet. Ist beides nicht gesetzt, wird jeder Aufruf abgelehnt, und die Meldung sagt, wie du das behebst. Jeder Pfad muss absolut sein, und export_markdown_to_pdf schreibt immer nur eine .pdf-Datei, nie über einen symbolischen Link.

Sicherheit: Aktualisiere auf 0.2.1. Mit 0.1.0 und 0.2.0 konnte ein Aufruf ein PDF an jeden Pfad schreiben, auf den dein Benutzerkonto schreiben durfte; behoben als GHSA-fqgj-hcxc-34qc.

Derselbe Export, drei Türen

Egal, welcher Weg es aufruft, das Verhalten darunter ändert sich nicht: derselbe Exporter, dieselben Themen und Papierformate, dieselben diagramErrors, wenn ein Mermaid-Diagramm nicht gerendert werden kann. Diese Seite wiederholt diesen Vertrag nicht; das tut marsdawn für Agenten, vollständig.

Weiter

Das vollständige JSON-Schema und jeder Exit-Code: marsdawn für Agenten.
Der Skill in einer Datei für Claude Code und ähnliche Agenten: der marsdawn-Skill.
Warum ein kompaktes JSON-Ergebnis für den eigenen Kontext deines Agenten zählt: Token-sparsames Prüfen.