obsidian_write_note

Obsidian · macOS · Windows

Efeito: escrita. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Grava uma nota Markdown em um cofre do Obsidian. mode="create" grava uma nota nova (as pastas ausentes são criadas); mode="append" acrescenta `content` ao final de uma nota existente. Chamada sem confirm, retorna uma prévia e não grava nada; passe confirm=true para gravar. Uma nota existente nunca é substituída, e a pasta de configurações do Obsidian nunca é gravada.

Entradas obrigatórias

path
content
mode

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

Esquema técnico canónico em inglês — macOS

{
  "properties": {
    "confirm": {
      "description": "Must be true to write. Without it the call returns a preview.",
      "type": "boolean"
    },
    "content": {
      "description": "Markdown text to write.",
      "type": "string"
    },
    "mode": {
      "description": "create: a new note. append: add to the end of an existing note.",
      "enum": [
        "create",
        "append"
      ],
      "type": "string"
    },
    "path": {
      "description": "Path of the note inside the vault, like Projects/Plan.md (.md is added when missing).",
      "type": "string"
    },
    "vault": {
      "description": "Vault name or id from obsidian_list_vaults. Optional when there is only one vault.",
      "type": "string"
    }
  },
  "required": [
    "path",
    "content",
    "mode"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para obsidian_write_note. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

{
  "confirm": false,
  "content": "## Planning meeting\n\n- Can we review the launch checklist on Tuesday?",
  "mode": "create",
  "path": "Meetings/Planning meeting.md",
  "vault": "Demo Vault"
}

Windows