Tres formas de llamar a marsdawn.

MarsDawn no tiene un modelo de IA propio: está hecho para revisar Markdown, no para escribirlo, así que no importa qué agente o modelo generó el archivo. Hay tres formas de que un agente o un script llame a marsdawn, y las tres terminan ejecutando el mismo export.

Elige la que admitan tus herramientas: la CLI gratuita marsdawn, un archivo de skill en Markdown simple o el servidor MCP marsdawn-mcp. Los tres llaman al mismo marsdawn export y devuelven el mismo resultado JSON.

Cuál usar

Si tu agente	Usa	Necesita
Puede ejecutar un comando de shell	La CLI	macOS 15 o posterior
Carga archivos de instrucciones, como Claude Code	El archivo de skill	La CLI, que la skill instala
Llama a herramientas por MCP	marsdawn-mcp	marsdawn-mcp 0.2.1 o posterior, marsdawn 0.5.0 o posterior y Node.js 20 o posterior

La CLI

marsdawn export notes.md --json lo puede llamar cualquier agente o script capaz de ejecutar un comando de shell, así que no depende de ningún modelo. Cada campo que devuelve está documentado en marsdawn para agentes, la fuente de referencia del esquema JSON a la que remiten las otras dos opciones de abajo.

El archivo de skill

Para un agente que lee instrucciones en Markdown simple en lugar de llamar directamente a una shell (hoy, Claude Code), la skill de marsdawn es un archivo que le enseña a instalar marsdawn, ejecutar export y leer el resultado. Es Markdown simple, así que otros agentes que cargan archivos de instrucciones pueden usar el mismo.

El servidor MCP

marsdawn-mcp es un repositorio aparte, público y con licencia Apache-2.0. Es un servidor MCP con dos herramientas, export_markdown_to_pdf y open_in_marsdawn, que envuelven marsdawn export --json y marsdawn open --json: apunta un cliente MCP hacia él y una llamada a una herramienta devuelve el mismo JSON que la CLI.

Dónde obtenerlo: como MCP Bundle, marsdawn.mcpb, adjunto a su release de GitHub, o ejecutando el servidor desde el código fuente por stdio.
Registro: aparece en el MCP Registry como dev.southern-light.mcp/marsdawn.
Alojamiento: solo autoalojado. No existe un servicio de marsdawn-mcp alojado; el servidor se ejecuta en tu propia máquina, junto a marsdawn.
Requisitos: macOS, marsdawn 0.5.0 o posterior y Node.js 20 o posterior para ejecutar el servidor.

Limitado a las carpetas que permitas

Las dos herramientas solo acceden a las carpetas que permitas: el ajuste Allowed folders de la extensión, que empieza vacío y sin valores predefinidos, o bien las raíces que ofrece tu cliente MCP. Si no hay ninguno de los dos, se rechaza cada llamada, y el mensaje de rechazo explica cómo solucionarlo. Cada ruta tiene que ser absoluta, y export_markdown_to_pdf solo escribe un archivo .pdf, nunca a través de un enlace simbólico.

Seguridad: actualiza a 0.2.1. Las versiones 0.1.0 y 0.2.0 permitían que una llamada escribiera un PDF en cualquier ruta en la que tu cuenta pudiera escribir; se corrigió como GHSA-fqgj-hcxc-34qc.

La misma exportación, tres puertas

Sea cual sea la vía que lo llame, el comportamiento de fondo no cambia: el mismo exportador, los mismos temas y tamaños de papel, los mismos diagramErrors cuando un diagrama Mermaid no se puede renderizar. Esta página no repite ese contrato; marsdawn para agentes lo describe completo.

El esquema JSON completo y cada código de salida: marsdawn para agentes.
La skill de un solo archivo para Claude Code y agentes similares: la skill de marsdawn.
Por qué un resultado JSON compacto importa para el contexto de tu agente: revisión con pocos tokens.