SiYuan icon

SiYuan

Manage SiYuan notebooks, documents, blocks, attributes, and more. Designed for AI agent workflows.

Block → Append

AI-generated

Overview

The node appends content blocks into a specified parent block within a SiYuan document or container. It is useful for dynamically adding new content sections, such as notes or paragraphs, to existing documents or containers in a SiYuan workspace. For example, appending a new markdown block to a document to add additional information or updates.

Use Case Examples

  1. Appending a markdown block to a document to add a new paragraph.
  2. Adding a content block inside a container block to organize information hierarchically.

Properties

Name Meaning
Parent Block ID The ID of the parent block (document or container block) to add content into.
Content (Markdown) The Markdown content for the block to be appended.
Data Type The format of the content, either Markdown or DOM (HTML). Defaults to Markdown.

Output

JSON

  • success - Indicates whether the append operation was successful.
  • blockId - The ID of the newly appended block.
  • parentBlockId - The ID of the parent block where the content was appended.

Dependencies

  • Requires SiYuan API URL and API Token credentials for authentication.

Troubleshooting

  • Ensure the Parent Block ID is valid and exists in the SiYuan workspace.
  • Verify that the API URL and Token credentials are correctly configured and have necessary permissions.
  • If the content format is set to DOM (HTML), ensure the content is valid HTML to avoid errors.

Discussion