MarsDawn

marsdawn을 호출하는 세 가지 방법.

MarsDawn에는 자체 AI 모델이 없습니다. Markdown을 쓰는 것이 아니라 검토하려고 만든 앱이므로, 어떤 에이전트나 모델이 파일을 만들었는지는 상관없습니다. 에이전트나 스크립트가 marsdawn을 호출하는 방법은 세 가지이며, 세 가지 모두 결국 같은 export를 실행합니다.

쓰는 도구가 지원하는 것을 고르세요. 무료 marsdawn CLI, 일반 Markdown으로 된 스킬 파일, MCP 서버 marsdawn-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은 셸 명령을 실행할 수 있는 에이전트나 스크립트라면 무엇이든 호출할 수 있으므로, 구조상 특정 모델에 묶이지 않습니다. 반환하는 모든 필드는 에이전트를 위한 marsdawn에 문서화되어 있으며, 아래의 다른 두 방법도 JSON 스키마는 이 문서를 기준으로 삼습니다.

스킬 파일

셸을 직접 호출하지 않고 일반 Markdown 지침을 읽는 에이전트(현재는 Claude Code)를 위해, marsdawn 스킬은 marsdawn을 설치하고 export를 실행하고 결과를 읽는 법을 가르치는 파일 하나입니다. 일반 Markdown이므로 지침 파일을 불러오는 다른 에이전트도 같은 파일을 쓸 수 있습니다.

MCP 서버

marsdawn-mcp는 Apache-2.0 라이선스의 별도 공개 저장소입니다. export_markdown_to_pdf와 open_in_marsdawn 두 도구를 가진 MCP 서버로, 각각 marsdawn export --json과 marsdawn open --json을 감쌉니다. MCP 클라이언트가 이 서버를 가리키게 하면 도구 호출이 CLI와 같은 JSON을 돌려줍니다.

허용한 폴더 안에서만

두 도구 모두 여러분이 허용한 폴더 안에만 접근합니다. 확장 프로그램의 Allowed folders 설정(처음에는 비어 있고 기본값도 없음)이나, 그 대신 MCP 클라이언트가 제공하는 루트가 기준입니다. 둘 다 설정되어 있지 않으면 모든 호출이 거부되며, 거부 메시지에 해결 방법이 나옵니다. 모든 경로는 절대 경로여야 하고, export_markdown_to_pdf는 .pdf 파일만 쓰며 심볼릭 링크를 통해서는 절대 쓰지 않습니다.

보안: 0.2.1로 업데이트하세요. 0.1.0과 0.2.0에서는 호출 한 번으로 여러분의 계정이 쓸 수 있는 어떤 경로에든 PDF를 쓸 수 있었으며, GHSA-fqgj-hcxc-34qc로 수정되었습니다.

같은 내보내기, 세 개의 문

어느 쪽에서 호출하든 그 아래의 동작은 바뀌지 않습니다. 같은 내보내기 엔진, 같은 테마와 용지 크기, Mermaid 다이어그램 렌더링이 실패했을 때의 같은 diagramErrors. 이 페이지에서는 그 규약을 반복하지 않습니다. 전체 내용은 에이전트를 위한 marsdawn에 있습니다.

다음