Skip to content

Get

Fetch a diagram's Mermaid source by ID.

Usage

merfolk diagrams get <id> [flags]

Arguments

Argument Description
id The diagram ID (required)

Flags

Flag Description
--json Output as JSON including metadata

Examples

# Print diagram source to stdout
merfolk diagrams get abc123

# Get diagram with metadata as JSON
merfolk diagrams get abc123 --json

# Pipe source to a file
merfolk diagrams get abc123 > diagram.mmd

Output

Default output is the raw Mermaid source:

graph TD
  A[User] --> B[App]
  B --> C[Database]

With --json:

{
  "id": "abc123",
  "title": "My architecture",
  "content": "graph TD\n  A[User] --> B[App]",
  "updatedAt": "2024-01-15T10:30:00Z",
  "url": "https://app.merfolk.io/d/abc123"
}

Exit codes

Code Meaning
0 Success
2 Not authenticated
3 Diagram not found
Navigation

Type to search…

↑↓ navigate↵ selectEsc close