- name
Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections. Use when working with .canvas files, creating visual canvases, mind maps, flowcharts, or when the user mentions
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add obsidianmd/obsidian-skills --skill json-canvas -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add obsidianmd/obsidian-skills --skill json-canvas -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add obsidianmd/obsidian-skills --skill json-canvas -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add obsidianmd/obsidian-skills --skill json-canvas -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/obsidianmd/obsidian-skills/tree/HEAD/plugins/obsidian/skills/json-canvasFrom the publisher
A canvas file (.canvas) contains two top-level arrays following the JSON Canvas Spec 1.0:
{
"nodes": [],
"edges": []
}
nodes (optional): Array of node objectsedges (optional): Array of edge objects connecting nodes.canvas file with the base structure {"nodes": [], "edges": []}"6f0ad84f44ce9c17")id, type, x, y, width, heightfromNode and toNodefromNode/toNode values exist in the nodes array.canvas filex, y) that avoids overlapping existing nodes (leave 50-100px spacing)nodes arrayfromNode and toNode to the source and target IDsfromSide/toSide (top, right, bottom, left) for anchor pointslabel for descriptive text on the edgeedges arrayfromNode and toNode reference existing node IDs.canvas file as JSONidNodes are objects placed on the canvas. Array order determines z-index: first node = bottom layer, last node = top layer.
{
"id": "6f0ad84f44ce9c17",
"type": "text",
"x": 0,
"y": 0,
"width": 400,
"height": 200,
"text": "# Hello World\n\nThis is **Markdown** content."
}
Newline pitfall: Use \n for line breaks in JSON strings. Do not use the literal \\n -- Obsidian renders that as the characters \ and n.
Quote escaping pitfall: Double quotes inside text content must be escaped as \". For example, the text 公司的"外交官" must be stored as "text": "公司的\"外交官\"". Unescaped quotes break the JSON parse and the canvas will fail to render. When generating canvas JSON programmatically, always use a JSON serializer rather than manual string concatenation.
Write .canvas files directly. Don't create them with obsidian create content=, which turns every \n into a raw newline and breaks the JSON.
File path escaping: If a file name contains double quotes, they must be escaped as \" in the JSON string. For example, a file named My "Notes".md should be referenced as "file": "My \"Notes\".md".
{
"id": "a1b2c3d4e5f67890",
"type": "file",
"x": 500,
"y": 0,
"width": 400,
"height": 300,
"file": "Attachments/diagram.png"
}
{
"id": "c3d4e5f678901234",
"type": "link",
"x": 1000,
"y": 0,
"width": 400,
"height": 200,
"url": "https://obsidian.md"
}
Groups are visual containers for organizing other nodes. Position child nodes inside the group's bounds.
{
"id": "d4e5f6789012345a",
"type": "group",
"x": -50,
"y": -50,
"width": 1000,
"height": 600,
"label": "Project Overview",
"color": "4"
}
Edges connect nodes via fromNode and toNode IDs.
{
"id": "0123456789abcdef",
"fromNode": "6f0ad84f44ce9c17",
"fromSide": "right",
"toNode": "a1b2c3d4e5f67890",
"toSide": "left",
"toEnd": "arrow",
"label": "leads to"
}
The canvasColor type accepts either a hex string or a preset number:
Preset color values are intentionally undefined -- applications use their own brand colors.
Generate 16-character lowercase hexadecimal strings (64-bit random value):
"6f0ad84f44ce9c17"
"a3b2c1d0e9f8a7b6"
x increases right, y increases down; position is the top-left cornerCJK text sizing: CJK characters (Chinese, Japanese, Korean) are wider than Latin characters. For content primarily in CJK languages, multiply the suggested width by ~1.5× to avoid cramped layouts and awkward line breaks.
After creating or editing a canvas file, verify:
id values are unique across both nodes and edgesfromNode and toNode references an existing node IDtext for text nodes, file for file nodes, url for link nodes)type is one of: text, file, link, groupfromSide/toSide values are one of: top, right, bottom, leftfromEnd/toEnd values are one of: none, arrow"1" through "6" or valid hex (e.g., "#FF0000")text and file values are properly escaped as \"If validation fails, check for duplicate IDs, dangling edge references, or malformed JSON strings (especially unescaped newlines in text content).
See references/EXAMPLES.md for full canvas examples including mind maps, project boards, research canvases, and flowcharts.
© 2026 Skills Rack.
---name: json-canvasdescription: Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections. Use when working with…---# plugins/obsidian/skills/json-canvas/SKILL.mdOverview
Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections. Use when working with .canvas files, creating visual canvases, mind maps, flowcharts, or when the user mentions Canvas files in Obsidian.
FAQ
Download plugins/obsidian/skills/json-canvas/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/obsidianmd/obsidian-skills.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.