エージェントのトークンを使わずにレビューする。

このループでは、二つの別々のことがどちらも安く済みます。エージェントがツール呼び出しから受け取るもの、そして結果が正しく見えることを確認するのに必要なもの、です。

ツール呼び出しが返すのは小さな JSON オブジェクトであり、レンダリングされたページではありません。レンダリングされたページ自体は、人が MarsDawn の中で読みます。エージェントの context に読み戻されることは決してありません。

ツール呼び出し自体が安い

marsdawn export を、CLI、skill、またはMCP サーバーのいずれからでも呼び出すと、返ってくるのは精簡な JSON オブジェクトです：ok、output、pages、theme、paper、diagramErrors。完全なスキーマは export.v1.json にあります。そのどれもレンダリングされた文書そのものではありません。十数個の Mermaid 図がある50ページの PDF も、1ページのメモと同じ数のフィールドしか返しません。

レビューは、別のところで行われる

PDF ができたら、人がそれを開きます。MarsDawn でも、どんな PDF ビューアでも構いません。そして図、数式、レイアウトがレンダリングされた状態で読みます。エージェントは、それが正しく見えることを確認するために、レンダリング結果を自分の context に読み戻す必要はありません。レビューは別のウインドウ、別の画面で行われ、図がどう見えるかを説明するために token を使うもう一往復にはなりません。

これが避けられるもの

レンダリングされた Markdown やスクリーンショット、あるいはその説明を、書き出しが成功したことをエージェントに確認させるためだけに会話に貼り戻すこと。
エージェントが、Mermaid 図や KaTeX の数式がどう描画されるかを、人が見れば済むところを自分で再構成しなければならないこと。
最初の呼び出しがすでに成功を報告した後で、PDF の内容を取得するために二度目のツール呼び出しをすること。

次に

marsdawn を呼び出す三つの方法、CLI、skill ファイル、MCP サーバー：三つの入り口。
JSON 結果のすべてのフィールド：AI エージェント向け marsdawn。
なぜ人がエージェントの書いたものを読む必要が今もあるのか：レビューが必要な理由。