json-canvas

Generate and edit JSON Canvas files with structured nodes, edges, and groups.

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/giwankim/obsidian-vault --skill json-canvas-giwankim
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: json-canvas
Source: https://github.com/giwankim/obsidian-vault/tree/main/.agents/skills/json-canvas
Command: npx skills add https://github.com/giwankim/obsidian-vault --skill json-canvas-giwankim

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

JSON Canvas files enable precise, structured representations of visual canvases (nodes, edges, groups) that would be error-prone if hand-edited, improving consistency and interoperability across tools.

Core Features & Use Cases

  • Structured canvas data: Define nodes (text, file, link, group) with positions, sizes, and styling.
  • Edges and layout: Connect nodes with edges and manage z-index for correct layering.
  • Use Case: Build a mind map or flowchart for a project in Obsidian by exporting a .canvas file and rendering it in compatible viewers.

Quick Start

Start a new canvas by defining at least one node and an edge in a .canvas file to begin visualization.

Frequently Asked Questions about json-canvas

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I programmatically create a JSON Canvas file for Obsidian?

To create a JSON Canvas file, define a structured schema for nodes, edges, and groups with specific positions, sizes, and styling. This enforces validation rules as defined by the JSON Canvas spec for programmatic generation.

What is the JSON Canvas format used for in mind maps and diagrams?

The JSON Canvas format provides a structured representation of visual canvases like mind maps and diagrams. It defines nodes, edges, and groups to ensure consistency and interoperability across compatible tools without error-prone hand-editing.

Can I use this to generate flowcharts with nodes and edges in a .canvas file?

Yes, you can generate flowcharts by defining text, file, link, or group nodes and connecting them with edges. The schema manages positions, sizes, color presets, and z-index for correct layering within the .canvas file.

Does the JSON Canvas spec support color presets and z-index for visual canvases?

Yes, the JSON Canvas spec enforces color presets and manages z-index for correct layering. This allows you to style nodes and ensure proper visual stacking when designing visual canvases or workflows.

What's the best way to edit .canvas files without manual JSON errors?

The best way to avoid manual JSON errors is using a structured schema that enforces node types, positions, edges, and validation rules. This programmatic approach ensures consistency and interoperability across tools like Obsidian.

Are there limitations to the JSON Canvas schema for complex graph structures?

The JSON Canvas schema enforces specific node types, positions, sizes, and validation rules. Complex graph structures must adhere to these defined structural constraints, limiting unstructured or free-form canvas representations.