Write Vault Section

Append or replace a named markdown section in an Obsidian vault note. Handles idempotency (replace if exists, append if not), section positioning, missing notes, and Obsidian CLI with filesystem fallback.

Inputs

• note_path (required): path to the note relative to vault root (e.g., Daily Notes/2026-04-07.md)
• section_heading (required): the heading to insert or replace (e.g., ### Intervals, ### FreshBooks, ### Coding Sessions)
• content (required): the full markdown content to place under the heading (including any tables, bullet lists, etc.)
• vault_root (required): path to the Obsidian vault root
• position_hint (optional): where to insert if the section doesn't exist yet. One of:
  • before:<heading> — insert before the named heading (e.g., before:### Coding Sessions)
  • after:<heading> — insert after the named heading and its content
  • end — append at end of note (default)
• separator (optional): text to prepend before the section heading. Default: ------ (horizontal rule). Set to empty string to skip.
• create_if_missing (optional): if the note doesn't exist, create it with a minimal # {date} header. Default: false.

Process