调用 marsdawn 的三种方式。

MarsDawn 没有自己的 AI 模型：它是为了审阅 Markdown 而做的，不是用来写的，所以是哪个 agent 或模型写出这份 Markdown 并不重要。agent 或脚本调用 marsdawn 有三种方式，最后都会运行同一个 export。

挑你的工具支持的那一种：免费的 marsdawn CLI、纯 Markdown 的 skill 文件，或是 marsdawn-mcp 这个 MCP 服务器。三者都调用同一个 marsdawn export，返回一样的 JSON 结果。

CLI

marsdawn export notes.md --json 可以被任何能运行 shell 命令的 agent 或脚本调用，因为是命令行工具，天生就跟模型无关。它返回的每个字段都写在给 AI agent 的 marsdawn 参考里，那一页是 JSON schema 的权威来源，下面另外两种方式都会连回去。

Skill 文件

如果你的 agent 读的是纯 Markdown 指令，而不是直接运行 shell——目前是 Claude Code——marsdawn skill 就是一个文件，教它安装 marsdawn、运行 export、读懂结果。因为它就是纯 Markdown，其他会读指令文件的 agent 也能用同一个文件。

MCP 服务器

marsdawn-mcp 是另一个独立、公开、Apache-2.0 授权的 repository。它是一个只有一个工具的 MCP 服务器，export_markdown_to_pdf，包住 marsdawn export --json：把 MCP 客户端指向它，工具调用返回的 JSON 和 CLI 一样。

获取方式：以 MCP Bundle（marsdawn.mcpb）的形式附在GitHub release 上，或从源代码以 stdio 运行服务器。
Registry：还没上架 MCP Registry（目前版本：0.1.0）。要靠 registry 搜索找到它之前，请先到 repository 确认目前状态。
托管：只能自架，没有代管服务。服务器跑在你自己的机器上，就在 marsdawn 旁边。
系统要求：macOS、marsdawn 0.5.0 以上，以及运行服务器需要的 Node.js 20 以上。

同一个 export，三扇门

不管从哪个界面调用，底层行为都一样：同一套输出程序、同样的主题和纸张大小，Mermaid 图表画不出来时也是同样的 diagramErrors。这页不重复那份规格——给 AI agent 的 marsdawn 参考里有完整内容。

接下来

完整 JSON schema 和所有退出代码：给 AI agent 的 marsdawn 参考。
给 Claude Code 等 agent 用的一个文件：marsdawn skill。
精简的 JSON 结果为什么对 agent 自己的 context 很重要：节省 token 的审阅方式。