MarsDawn

marsdawn を呼び出す三つの方法。

MarsDawn には自前の AI モデルがありません。Markdown を書くためではなく、レビューするために作られているので、どのエージェントやモデルがそのファイルを作ったかは関係ありません。エージェントやスクリプトが marsdawn を呼び出す方法は三つあり、どれも最終的に同じ export を実行します。

使っているツールが対応しているものを選んでください：無料の marsdawn CLI、プレーンな Markdown の skill ファイル、または marsdawn-mcp という MCP サーバーです。三つとも同じ marsdawn export を呼び出し、同じ JSON 結果を返します。

どれを使うか

エージェントが使うもの必要なもの
シェルコマンドを実行できるCLImacOS 15 以降
Claude Code のように指示ファイルを読み込むスキルファイルCLI（スキルがインストールします）
MCP でツールを呼び出すmarsdawn-mcpmarsdawn-mcp 0.2.1 以降、marsdawn 0.5.0 以降、Node.js 20 以降

CLI

marsdawn export notes.md --json は、シェルコマンドを実行できるエージェントやスクリプトならどれからでも呼び出せます。構造上、モデルに依存しません。返されるすべてのフィールドはAI エージェント向け marsdawnに文書化されており、そこが JSON スキーマの正典で、以下の二つの経路もそこを参照します。

skill ファイル

シェルを直接呼び出すのではなく、プレーンな Markdown の指示を読むエージェント向け——現時点では Claude Code——には、marsdawn skill という1ファイルが、marsdawn のインストール、export の実行、結果の読み取りを教えます。プレーンな Markdown なので、指示ファイルを読み込む他のエージェントも同じファイルを使えます。

MCP サーバー

marsdawn-mcp は、別の、公開された、Apache-2.0 ライセンスの独立した repository です。export_markdown_to_pdf と open_in_marsdawn という2つのツールを持つ MCP サーバーで、それぞれ marsdawn export --json と marsdawn open --json をラップしています。MCP クライアントをそれに向ければ、ツール呼び出しは CLI と同じ JSON を返します。

許可したフォルダの中でしか動きません

両方のツールとも、許可したフォルダの中でしか読み書きしません：拡張機能の「Allowed folders」設定（デフォルトは空です）、またはお使いの MCP クライアントが提供する roots のどちらかです。どちらも設定されていない場合、すべての呼び出しは拒否され、拒否メッセージに設定方法が書かれています。パスはすべて絶対パスである必要があり、export_markdown_to_pdf が書き出すのは .pdf ファイルだけで、シンボリックリンク経由で書き込むことはありません。

セキュリティ：0.2.1 に更新してください——0.1.0 と 0.2.0 では、呼び出しがあなたのアカウントが書き込めるどのパスにも PDF を書き込めてしまう問題があり、GHSA-fqgj-hcxc-34qc で修正されました。

同じ export、三つの入り口

どの入り口から呼び出しても、内部の動作は変わりません。同じ書き出しエンジン、同じテーマと紙のサイズ、Mermaid 図の描画に失敗したときの同じ diagramErrors。このページではその契約内容を繰り返しません。AI エージェント向け marsdawnに完全な内容があります。

次に