Habilidade JSON Canvas

Quando Usar

• Use ao criar ou editar arquivos .canvas para o Obsidian.
• Use para mapas mentais, fluxogramas, estruturas de notas visuais ou telas conectadas.
• Use quando o usuário mencionar explicitamente arquivos JSON Canvas ou Obsidian Canvas.

Estrutura de Arquivo

Um arquivo de tela (.canvas) contém dois arrays de nível superior seguindo a Especificação JSON Canvas 1.0:

{
  "nodes": [],
  "edges": []
}

• nodes (opcional): Array de objetos de nó
• edges (opcional): Array de objetos de aresta conectando nós

Fluxos de Trabalho Comuns

1. Criar uma Nova Tela

1. Crie um arquivo .canvas com a estrutura base {"nodes": [], "edges": []}
2. Gere IDs hexadecimais únicos de 16 caracteres para cada nó (por exemplo, "6f0ad84f44ce9c17")
3. Adicione nós com os campos obrigatórios: id, type, x, y, width, height
4. Adicione arestas referenciando IDs de nó válidos via fromNode e toNode
5. Validar: Analise o JSON para confirmar que é válido. Verifique se todos os valores fromNode/toNode existem no array de nós

2. Adicionar um Nó a uma Tela Existente

1. Leia e analise o arquivo .canvas existente
2. Gere um ID único que não colida com os IDs de nó ou aresta existentes
3. Escolha a posição (x, y) que evite sobrepor nós existentes (deixe um espaçamento de 50-100px)
4. Anexe o novo objeto de nó ao array nodes
5. Opcionalmente, adicione arestas conectando o novo nó aos nós existentes
6. Validar: Confirme se todos os IDs são únicos e se todas as referências de aresta resolvem para nós existentes

3. Conectar Dois Nós

1. Identifique os IDs do nó de origem e de destino
2. Gere um ID de aresta único
3. Defina fromNode e toNode para os IDs de origem e destino
4. Opcionalmente, defina fromSide/toSide (superior, direito, inferior, esquerdo) para pontos de ancoragem
5. Opcionalmente, defina label para texto descritivo na aresta
6. Anexe a aresta ao array edges
7. Validar: Confirme se ambos fromNode e toNode referenciam IDs de nó existentes

4. Editar uma Tela Existente

1. Leia e analise o arquivo .canvas como JSON
2. Localize o nó ou aresta de destino por id
3. Modifique os atributos desejados (texto, posição, cor, etc.)
4. Escreva o JSON atualizado de volta no arquivo
5. Validar: Verifique novamente a exclusividade de todos os IDs e a integridade das referências de aresta após a edição

Nós

Nós são objetos colocados na tela. A ordem do array determina o z-index: primeiro nó = camada inferior, último nó = camada superior.

Atributos Genéricos de Nó

Nós de Texto

{
  "id": "6f0ad84f44ce9c17",
  "type": "text",
  "x": 0,
  "y": 0,
  "width": 400,
  "height": 200,
  "text": "# Hello World\n\nThis is **Markdown** content."
}

Armadilha de nova linha: Use \n para quebras de linha em strings JSON. Não use o literal \\n -- o Obsidian renderiza isso como os caracteres \ e n.

Nós de Arquivo

{
  "id": "a1b2c3d4e5f67890",
  "type": "file",
  "x": 500,
  "y": 0,
  "width": 400,
  "height": 300,
  "file": "Attachments/diagram.png"
}

Nós de Link

{
  "id": "c3d4e5f678901234",
  "type": "link",
  "x": 1000,
  "y": 0,
  "width": 400,
  "height": 200,
  "url": "https://obsidian.md"
}

Nós de Grupo

Grupos são contêineres visuais para organizar outros nós. Posicione os nós filhos dentro dos limites do grupo.

{

…