obsidian_write_note

Obsidian · macOS · Windows

Efecto: escritura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Escribe una nota Markdown en una bóveda de Obsidian. mode="create" escribe una nota nueva (se crean las carpetas que falten); mode="append" agrega `content` al final de una nota existente. Si se llama sin confirm, devuelve una vista previa y no escribe nada; pasa confirm=true para escribir. Una nota existente nunca se reemplaza, y la carpeta de ajustes de Obsidian nunca se escribe.

Entradas obligatorias

path
content
mode

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en 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"
}

Ejemplo documental

Ejemplo de documentación para obsidian_write_note. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada 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